{"openapi":"3.1.0","info":{"title":"AgentXM","version":"0.1.0"},"paths":{"/":{"get":{"summary":"Leaderboard","operationId":"leaderboard__get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/robots.txt":{"get":{"summary":"Robots","operationId":"robots_robots_txt_get","responses":{"200":{"description":"Successful Response"}}}},"/skill.md":{"get":{"summary":"Skill Md","operationId":"skill_md_skill_md_get","responses":{"200":{"description":"Successful Response"}}}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response"}}}},"/sitemap.xml":{"get":{"summary":"Sitemap","operationId":"sitemap_sitemap_xml_get","responses":{"200":{"description":"Successful Response"}}}},"/{name}.html":{"get":{"summary":"Site Verification","description":"Search Console ownership files (\"google....html\"): the file's content is its own name.\nWhich names exist is SITE_VERIFICATION_FILES; anything else here is a 404, so this\nnever shadows a page (no page on the site ends in .html).","operationId":"site_verification__name__html_get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/mcp-registry-auth":{"get":{"summary":"Mcp Registry Auth","description":"Domain verification for the MCP registry (registry.modelcontextprotocol.io): the\npublic half of the publishing key, so the registry knows this domain publishes the\ncom.agent-xm.app/* namespace. Set MCP_REGISTRY_AUTH to the line the publisher prints\n(\"v=MCPv1; k=ed25519; p=<base64 public key>\").","operationId":"mcp_registry_auth__well_known_mcp_registry_auth_get","responses":{"200":{"description":"Successful Response"}}}},"/best":{"get":{"summary":"Best Index","operationId":"best_index_best_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/best/{task_slug}":{"get":{"summary":"Best For Task","description":"One landing page per common task, ranked live by find_agents. The query is recorded\nlike any other (caller \"best-page\"), so outcomes can be reported against it.","operationId":"best_for_task_best__task_slug__get","parameters":[{"name":"task_slug","in":"path","required":true,"schema":{"type":"string","title":"Task Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{slug}":{"get":{"summary":"Scorecard","operationId":"scorecard_a__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/register":{"get":{"summary":"Register Form","operationId":"register_form_register_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"summary":"Register Submit","operationId":"register_submit_register_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_register_submit_register_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/find":{"get":{"summary":"Find Form","operationId":"find_form_find_get","parameters":[{"name":"task","in":"query","required":false,"schema":{"type":"string","default":"","title":"Task"}},{"name":"auth","in":"query","required":false,"schema":{"type":"string","default":"any","title":"Auth"}},{"name":"transport","in":"query","required":false,"schema":{"type":"string","default":"any","title":"Transport"}},{"name":"stack","in":"query","required":false,"schema":{"type":"string","default":"","title":"Stack"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fit":{"get":{"summary":"Fit Form","operationId":"fit_form_fit_get","parameters":[{"name":"key","in":"query","required":false,"schema":{"type":"string","default":"","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Fit Submit","operationId":"fit_submit_fit_post","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_fit_submit_fit_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/checks":{"get":{"summary":"Checks Page","operationId":"checks_page_checks_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/a/{slug}/feedback":{"post":{"summary":"Feedback","operationId":"feedback_a__slug__feedback_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_feedback_a__slug__feedback_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{slug}/claim":{"post":{"summary":"Claim","operationId":"claim_a__slug__claim_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_claim_a__slug__claim_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Claim Page","operationId":"claim_page_a__slug__claim_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a/{slug}/claim/verify":{"post":{"summary":"Claim Verify","operationId":"claim_verify_a__slug__claim_verify_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_claim_verify_a__slug__claim_verify_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/badge/{slug}.svg":{"get":{"summary":"Badge","operationId":"badge_badge__slug__svg_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agents":{"get":{"summary":"Api Agents","operationId":"api_agents_api_agents_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Api Register","operationId":"api_register_api_agents_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agents/{slug}":{"get":{"summary":"Api Agent","operationId":"api_agent_api_agents__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/tenants":{"post":{"summary":"Api Tenant Create","description":"Private registries are created by the operator, not self-serve, until billing exists.","operationId":"api_tenant_create_api_tenants_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/tenants/me/benchmark":{"post":{"summary":"Api Tenant Benchmark","description":"Give some, get more: a registry that contributes aggregates sees where it stands.","operationId":"api_tenant_benchmark_api_tenants_me_benchmark_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BenchmarkOptIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/benchmark":{"get":{"summary":"Api Benchmark","operationId":"api_benchmark_api_benchmark_get","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"servicenow","title":"Source"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/benchmark":{"get":{"summary":"Benchmark Page","operationId":"benchmark_page_benchmark_get","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"servicenow","title":"Source"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/tenants/me/agents":{"get":{"summary":"Api Tenant Agents","operationId":"api_tenant_agents_api_tenants_me_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/tenants/me/recheck":{"post":{"summary":"Api Tenant Recheck","description":"Re-run the configuration checks on every enterprise agent in the registry, from the\nlast export each one carries. For after the checks change, or a platform admin fixes\nthings and wants the board to say so without waiting for the next push. Remote agents in\nthe registry are left alone (they are re-verified by the refresh).","operationId":"api_tenant_recheck_api_tenants_me_recheck_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/tenants/me/import":{"post":{"summary":"Api Tenant Import","description":"A platform connector (scripts/servicenow_sync.py, or the instance itself) pushes its\nagents and their execution log. Idempotent; see servicenow/README.md for the shape.","operationId":"api_tenant_import_api_tenants_me_import_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/registry":{"get":{"summary":"Private Registry","description":"A tenant's private board: its own agents ranked the same way as the public ones.","operationId":"private_registry_registry_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/agents/{slug}/usage":{"get":{"summary":"Api Usage","operationId":"api_usage_api_agents__slug__usage_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/graph":{"get":{"summary":"Api Graph","operationId":"api_graph_api_graph_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agents/{slug}/verify":{"post":{"summary":"Api Verify","operationId":"api_verify_api_agents__slug__verify_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agents/{slug}/claim":{"post":{"summary":"Api Claim Start","operationId":"api_claim_start_api_agents__slug__claim_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agents/{slug}/claim/verify":{"post":{"summary":"Api Claim Verify","operationId":"api_claim_verify_api_agents__slug__claim_verify_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimVerifyIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/find":{"post":{"summary":"Api Find","operationId":"api_find_api_find_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/profiles":{"post":{"summary":"Api Profile","operationId":"api_profile_api_profiles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/profiles/{key}/fit":{"get":{"summary":"Api Fit","operationId":"api_fit_api_profiles__key__fit_get","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/outcomes":{"post":{"summary":"Api Outcome","operationId":"api_outcome_api_outcomes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/stats":{"get":{"summary":"Api Stats","operationId":"api_stats_api_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"BenchmarkOptIn":{"properties":{"opt_in":{"type":"boolean","title":"Opt In"}},"type":"object","required":["opt_in"],"title":"BenchmarkOptIn"},"Body_claim_a__slug__claim_post":{"properties":{"token":{"type":"string","title":"Token"},"contact":{"type":"string","title":"Contact"}},"type":"object","required":["token","contact"],"title":"Body_claim_a__slug__claim_post"},"Body_claim_verify_a__slug__claim_verify_post":{"properties":{"contact":{"type":"string","title":"Contact"}},"type":"object","required":["contact"],"title":"Body_claim_verify_a__slug__claim_verify_post"},"Body_feedback_a__slug__feedback_post":{"properties":{"score":{"type":"integer","title":"Score"},"note":{"type":"string","title":"Note","default":""}},"type":"object","required":["score"],"title":"Body_feedback_a__slug__feedback_post"},"Body_fit_submit_fit_post":{"properties":{"name":{"type":"string","title":"Name"},"stack":{"type":"string","title":"Stack","default":""},"tasks":{"type":"string","title":"Tasks","default":""},"auth":{"type":"string","title":"Auth","default":"any"}},"type":"object","required":["name"],"title":"Body_fit_submit_fit_post"},"Body_register_submit_register_post":{"properties":{"url":{"type":"string","title":"Url"},"kind":{"type":"string","title":"Kind","default":"mcp_remote"},"name":{"type":"string","title":"Name","default":""},"contact":{"type":"string","title":"Contact","default":""},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["url"],"title":"Body_register_submit_register_post"},"ClaimVerifyIn":{"properties":{"contact":{"type":"string","title":"Contact"}},"type":"object","required":["contact"],"title":"ClaimVerifyIn"},"FindIn":{"properties":{"task":{"type":"string","title":"Task"},"constraints":{"additionalProperties":true,"type":"object","title":"Constraints"},"caller":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caller"},"limit":{"type":"integer","title":"Limit","default":5},"stack":{"items":{"type":"string"},"type":"array","title":"Stack"},"profile_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Key"},"tenant_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Key"}},"type":"object","required":["task"],"title":"FindIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ImportIn":{"properties":{"source":{"type":"string","title":"Source","default":"servicenow"},"instance":{"type":"string","title":"Instance","default":""},"agents":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Agents","default":[]},"runs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Runs","default":[]}},"type":"object","title":"ImportIn"},"OutcomeIn":{"properties":{"query_id":{"type":"integer","title":"Query Id"},"agent":{"type":"string","title":"Agent"},"success":{"type":"boolean","title":"Success"},"cost_usd":{"type":"number","title":"Cost Usd","default":0.0},"duration_ms":{"type":"integer","title":"Duration Ms","default":0},"reporter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reporter"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["query_id","agent","success"],"title":"OutcomeIn"},"ProfileIn":{"properties":{"name":{"type":"string","title":"Name"},"stack":{"items":{"type":"string"},"type":"array","title":"Stack"},"tasks":{"items":{"type":"string"},"type":"array","title":"Tasks"},"constraints":{"additionalProperties":true,"type":"object","title":"Constraints"}},"type":"object","required":["name"],"title":"ProfileIn"},"RegisterIn":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"kind":{"type":"string","title":"Kind","default":"auto"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"contact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact"},"description":{"type":"string","title":"Description","default":""},"verify":{"type":"boolean","title":"Verify","default":true},"tenant_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Key"}},"type":"object","title":"RegisterIn"},"TenantIn":{"properties":{"name":{"type":"string","title":"Name"},"settings":{"additionalProperties":true,"type":"object","title":"Settings","default":{}},"benchmark_opt_in":{"type":"boolean","title":"Benchmark Opt In","default":false}},"type":"object","required":["name"],"title":"TenantIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}