MCP

Discover By Intent Post

POST variant — JSON body q / query / intent / search (SDK-compatible).

Optional body fields (parity with discovery.search):

  • semantic_contract: fingerprinted GoalSemanticContract — skips re-compile
  • observed: inverse orchestration slots (completed_steps, workflow_state_key)
  • include_scope: 1 / true — attach catalog scope stats (O(registry); opt-in)
  • domain, scope, focus_node_id: routing / hydrate gate (same as GET query)
  • supplements: pre-built archetype/recipe block (skip rebuild in intent payload)
post/mcp/discover/by_intent

Request

  • Base URL: https://api.agentstack.tech (the document declares no server; this is the origin it was published from)
  • URL: https://api.agentstack.tech/mcp/discover/by_intent
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

intentstring nullable

Intent description (e.g., 'create card game')

querystring nullable

Alias for intent (legacy GET clients)

qstring nullable

Discovery search term (parity with discovery.search)

searchstring nullable

Alias for q/query (discovery.search parity)

categorystring nullable

Optional category filter

tokensstring nullable

Admin debug: comma GTPI tokens — adds gtpi_debug bindings

Headers

Idempotency-Keystring

Client-generated key to make mutating requests idempotent.

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.