Every API here is available over the APIs.io API and to AI agents over MCP.
{"openapi":"3.1.0","info":{"title":"Macaroon Network Agent Services","description":"Pay-per-call scientific search, evidence, validation, and simulation services with explicit provenance and limitations.","version":"1.0.0","x-guidance":"Choose a concrete POST /execute/<capability-id> operation. Send the documented JSON body, receive an x402 v2 USDC challenge on Base, then retry with PAYMENT-SIGNATURE. Treat licence status and validation claims exactly as returned; unknown evidence is not permission."},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/":{"get":{"summary":"Api Root","description":"Small, stable entry point for clients that probe the API hostname.","operationId":"api_root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Api Root Get"}}}}}}},"/robots.txt":{"get":{"summary":"Api Robots","description":"Let indexers find public contracts while avoiding private commerce paths.","operationId":"api_robots_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/provider/whoami":{"get":{"summary":"Provider Whoami","operationId":"provider_whoami_api_provider_whoami_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Provider Whoami Api Provider Whoami Get"}}}}}}},"/api/provider/candidates":{"post":{"summary":"Submit Provider Candidate","operationId":"submit_provider_candidate_api_provider_candidates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateSubmission"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Submit Provider Candidate Api Provider Candidates Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/provider/candidates/{submission_id}":{"get":{"summary":"Get Provider Candidate Status","operationId":"get_provider_candidate_status_api_provider_candidates__submission_id__get","parameters":[{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Provider Candidate Status Api Provider Candidates Submission Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/listings":{"get":{"summary":"Get Listings","operationId":"get_listings_listings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingsResponse"}}}}}},"post":{"summary":"Create Listing","operationId":"create_listing_listings_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Manifest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Listing"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/listings/search":{"get":{"summary":"Search Listings","operationId":"search_listings_listings_search_get","parameters":[{"name":"intent","in":"query","required":true,"schema":{"type":"string","title":"Intent"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/listings/{capability_id}":{"get":{"summary":"Get Listing","operationId":"get_listing_listings__capability_id__get","parameters":[{"name":"capability_id","in":"path","required":true,"schema":{"type":"string","title":"Capability Id"},"description":"Substitute a concrete capability id; do not send the literal {capability_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Listing"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Listing","operationId":"delete_listing_listings__capability_id__delete","parameters":[{"name":"capability_id","in":"path","required":true,"schema":{"type":"string","title":"Capability Id"},"description":"Substitute a concrete capability id; do not send the literal {capability_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/stats":{"get":{"summary":"Public Marketplace Stats","description":"Backs the homepage's real \"Independent Sales (24h)\" stat card --\ndeliberately a minimal, public-safe shape (a count and a revenue\ntotal), never the raw payment_reference/service_id rows\ncommercial_events.commercial_report()'s unrecognized_payments list\ncarries. Real, rolling 24h window -- never a hardcoded figure, per\nthis project's own \"counts are never invented\" rule.","operationId":"public_marketplace_stats_api_public_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMarketplaceStatsResponse"}}}}}}},"/api/public/taxonomy":{"get":{"summary":"Public Catalog Taxonomy","description":"Return Macaroon-owned canonical categories with mapped product counts.","operationId":"public_catalog_taxonomy_api_public_taxonomy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Catalog Taxonomy Api Public Taxonomy Get"}}}}}}},"/api/public/mcp-servers":{"get":{"summary":"Public Mcp Servers","description":"Return only MCP servers that are evidenced as live.","operationId":"public_mcp_servers_api_public_mcp_servers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Mcp Servers Api Public Mcp Servers Get"}}}}}}},"/api/public/sources":{"get":{"summary":"Public Sources","description":"Return reviewed public source records and explicit coverage limits.","operationId":"public_sources_api_public_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Sources Api Public Sources Get"}}}}}}},"/api/public/services":{"get":{"summary":"Public Services","operationId":"public_services_api_public_services_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicServicesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/services/search":{"get":{"summary":"Public Service Search","operationId":"public_service_search_api_public_services_search_get","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Query"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicServicesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/scripture-lookup":{"post":{"summary":"Public Gpt Faith Scripture Lookup","description":"Return at most five exact, same-chapter verses from the pinned corpus.","operationId":"public_gpt_faith_scripture_lookup_api_public_gpt_faith_scripture_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GPTScriptureLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Scripture Lookup Api Public Gpt Faith Scripture Lookup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/action":{"post":{"summary":"Public Gpt Faith Action","description":"Single Builder-compatible dispatcher with a server-fixed faith scope.","operationId":"public_gpt_faith_action_api_public_gpt_faith_action_post","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/GPTFaithScriptureActionRequest"},{"$ref":"#/components/schemas/GPTFaithListActionRequest"},{"$ref":"#/components/schemas/GPTFaithSearchActionRequest"},{"$ref":"#/components/schemas/GPTFaithServiceActionRequest"}],"title":"Body","discriminator":{"propertyName":"action","mapping":{"scripture_lookup":"#/components/schemas/GPTFaithScriptureActionRequest","list_services":"#/components/schemas/GPTFaithListActionRequest","search_services":"#/components/schemas/GPTFaithSearchActionRequest","service_detail":"#/components/schemas/GPTFaithServiceActionRequest","service_evidence":"#/components/schemas/GPTFaithServiceActionRequest","service_page":"#/components/schemas/GPTFaithServiceActionRequest"}}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Action Api Public Gpt Faith Action Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/list":{"post":{"summary":"Public Gpt Faith Services List","operationId":"public_gpt_faith_services_list_api_public_gpt_faith_services_list_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Services List Api Public Gpt Faith Services List Post"}}}}}}},"/api/public/gpt/faith/services/search":{"post":{"summary":"Public Gpt Faith Services Search","operationId":"public_gpt_faith_services_search_api_public_gpt_faith_services_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GPTFaithSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Services Search Api Public Gpt Faith Services Search Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/detail":{"post":{"summary":"Public Gpt Faith Service Detail Post","operationId":"public_gpt_faith_service_detail_post_api_public_gpt_faith_services_detail_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GPTFaithServiceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Service Detail Post Api Public Gpt Faith Services Detail Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/evidence":{"post":{"summary":"Public Gpt Faith Service Evidence Post","operationId":"public_gpt_faith_service_evidence_post_api_public_gpt_faith_services_evidence_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GPTFaithServiceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Service Evidence Post Api Public Gpt Faith Services Evidence Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/page":{"post":{"summary":"Public Gpt Faith Service Page Post","operationId":"public_gpt_faith_service_page_post_api_public_gpt_faith_services_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GPTFaithServiceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Gpt Faith Service Page Post Api Public Gpt Faith Services Page Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/router/resolve":{"post":{"summary":"Router Resolve","operationId":"router_resolve_api_router_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouterResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouterResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/universal-search":{"post":{"summary":"Internal Universal Search","description":"Backend for universal-macaroon-search-v1's raw_input execute\nroute -- internal-only (not in Caddy's public path allowlist for\napi.macaroonnetwork.com, same as /internal/commercial/page-view),\nreachable only via execute.py's own loopback call to backend_url.","operationId":"internal_universal_search_internal_universal_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UniversalSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Internal Universal Search Internal Universal Search Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/services/{service_id}":{"get":{"summary":"Public Service Detail","operationId":"public_service_detail_api_public_services__service_id__get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"},"description":"Substitute a concrete service id; do not send the literal {service_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicServiceDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/{service_id}":{"get":{"summary":"Public Gpt Faith Service Detail","operationId":"public_gpt_faith_service_detail_api_public_gpt_faith_services__service_id__get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"},"description":"Substitute a concrete service id; do not send the literal {service_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicServiceDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/receipts/{receipt_id}":{"get":{"summary":"Get Receipt","operationId":"get_receipt_api_receipts__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"},"description":"Substitute a concrete receipt id; do not send the literal {receipt_id} template.","example":"receipt-id-from-a-paid-execution-response"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/services/{service_id}/evidence":{"get":{"summary":"Public Service Evidence","operationId":"public_service_evidence_api_public_services__service_id__evidence_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"},"description":"Substitute a concrete service id; do not send the literal {service_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Public Service Evidence Api Public Services Service Id Evidence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/{service_id}/evidence":{"get":{"summary":"Public Gpt Faith Service Evidence","operationId":"public_gpt_faith_service_evidence_api_public_gpt_faith_services__service_id__evidence_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"},"description":"Substitute a concrete service id; do not send the literal {service_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Public Gpt Faith Service Evidence Api Public Gpt Faith Services Service Id Evidence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/services/{service_id}/page":{"get":{"summary":"Public Service Page","operationId":"public_service_page_api_public_services__service_id__page_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"},"description":"Substitute a concrete service id; do not send the literal {service_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Public Service Page Api Public Services Service Id Page Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/gpt/faith/services/{service_id}/page":{"get":{"summary":"Public Gpt Faith Service Page","operationId":"public_gpt_faith_service_page_api_public_gpt_faith_services__service_id__page_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"},"description":"Substitute a concrete service id; do not send the literal {service_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Public Gpt Faith Service Page Api Public Gpt Faith Services Service Id Page Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/commercial/page-view":{"post":{"summary":"Commercial Page View","operationId":"commercial_page_view_internal_commercial_page_view_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommercialPageEvent"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing/email-signup":{"post":{"summary":"Marketing Email Signup","operationId":"marketing_email_signup_api_marketing_email_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Marketing Email Signup Api Marketing Email Signup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/execute/{capability_id}":{"get":{"summary":"Execute Payment Required","description":"Discovery crawlers (x402 Bazaar among them) GET the resource URL and\nindex it only if it answers 402. The real call is a POST carrying input\nand a predicate, so this exists purely to advertise the price -- it never\nexecutes anything and never takes payment.","operationId":"execute_payment_required_execute__capability_id__get","parameters":[{"name":"capability_id","in":"path","required":true,"schema":{"type":"string","title":"Capability Id"},"description":"Substitute a concrete capability id; do not send the literal {capability_id} template.","example":"sanctions-pep-screening-v1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Execute Payment Required Execute Capability Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Execute Capability","operationId":"execute_capability_execute__capability_id__post","parameters":[{"name":"capability_id","in":"path","required":true,"schema":{"type":"string","title":"Capability Id"},"description":"Substitute a concrete capability id; do not send the literal {capability_id} template.","example":"sanctions-pep-screening-v1"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Execute Capability Execute Capability Id Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent-card.json":{"get":{"summary":"A2A Agent Card","description":"A2A discovery document (X-ASYNC). Path and required fields are the\nspec's, not ours — see specs/X-ASYNC-a2a-async-execution.md.","operationId":"a2a_agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response A2A Agent Card Well Known Agent Card Json Get"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"A2A Agent Card Legacy Path","description":"The pre-v1.0 A2A path. The spec moved the Agent Card to\n/.well-known/agent-card.json at v0.3, but real-world adoption lags --\na 2026-07 survey of 65 A2A providers found 23% still only serve the\nold path -- and this repo's own production logs (2026-08-16) show\nreal crawler traffic checking exactly this path and getting a 404.\nServes the identical card, not a second source of truth.","operationId":"a2a_agent_card_legacy_path__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response A2A Agent Card Legacy Path Well Known Agent Json Get"}}}}}}},"/a2a":{"post":{"summary":"A2A Jsonrpc","description":"A2A JSON-RPC 2.0 endpoint.\n\nAlways HTTP 200: JSON-RPC carries failure in the `error` member, so\nreturning an HTTP error status for a well-formed call that the protocol\nalready has a code for would put the failure in two places and make\nconformant clients disagree with us about what happened.","operationId":"a2a_jsonrpc_a2a_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/a2a/health":{"get":{"summary":"A2A Health","description":"Read-only liveness response for A2A monitors; it performs no work.","operationId":"a2a_health_a2a_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response A2A Health A2A Health Get"}}}}}}},"/.well-known/x402":{"get":{"summary":"X402 Well Known","description":"Compatibility discovery document some directories check before (or\ninstead of) crawling /openapi.json -- see x402scan's docs/DISCOVERY.md\nsection B. Reuses the same live-rail predicate the OpenAPI x-payment-info\nexpansion already uses, never inferred from price alone.","operationId":"x402_well_known__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response X402 Well Known Well Known X402 Get"}}}}}}},"/.well-known/llms.txt":{"get":{"summary":"Llms Txt","description":"llms.txt (llmstxt.org convention -- not a ratified standard, but a\nwidely-adopted one). Root path is the dominant convention; the\n/.well-known mirror is served too since 2026-08-16 production logs\nshow real crawlers checking that path specifically. Listing count is\ncomputed live, never a hardcoded figure that could go stale or\noverclaim.","operationId":"llms_txt__well_known_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","description":"llms.txt (llmstxt.org convention -- not a ratified standard, but a\nwidely-adopted one). Root path is the dominant convention; the\n/.well-known mirror is served too since 2026-08-16 production logs\nshow real crawlers checking that path specifically. Listing count is\ncomputed live, never a hardcoded figure that could go stale or\noverclaim.","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent-capabilities":{"get":{"summary":"Agent Capabilities","operationId":"agent_capabilities__well_known_agent_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCapabilitiesResponse"}}}}}}},"/.well-known/ai-catalog.json":{"get":{"summary":"Ai Catalog","operationId":"ai_catalog__well_known_ai_catalog_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCatalogResponse"}}}}}}},"/.well-known/api-catalog":{"get":{"summary":"Api Catalog Linkset","description":"RFC 9727 API catalog -- a linkset document for a generic agent that\ndoesn't yet know anything macaroonnetwork-specific. One linkset entry\nper live capability (each is independently anchored and purchasable, so\neach is its own \"API\" per the RFC, not one entry for the whole\nmarketplace). service-desc always points at the shared OpenAPI document\n-- there's one combined spec, not one per capability.","operationId":"api_catalog_linkset__well_known_api_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"summary":"Oauth Protected Resource","description":"RFC 9728 Protected Resource Metadata. `authorization_servers` is\nRFC 9728's own optional field (Section 2) and is omitted rather than\npopulated with a value -- Macaroon Network has no OAuth authorization\nserver, and inventing one to satisfy a scanner would make this\ndocument false. Published purely so machine readers get a real,\nminimal RFC 9728 document instead of a 404; the actual access\ncontract is x402 payment, documented in full at /auth.md.","operationId":"oauth_protected_resource__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Oauth Protected Resource Well Known Oauth Protected Resource Get"}}}}}}},"/auth.md":{"get":{"summary":"Auth Md","description":"Auth.md agent-registration discovery (see auth.md's own spec).\nDeliberately does not claim OAuth, bearer tokens, API keys, or a\nregistration/claim flow this marketplace doesn't have -- an earlier\nversion of this route invented register_uri/claim_uri fields to\nchase a third-party readiness scanner's authMd check, which made the\nmachine-readable surface less truthful, not more compatible. The\ncorrect fix was publishing a real (if minimal) RFC 9728 document at\n/.well-known/oauth-protected-resource that truthfully omits\nauthorization_servers -- see that route -- and describing the real\naccess model (anonymous discovery + x402 payment) honestly\nhere instead.","operationId":"auth_md_auth_md_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/execute/tx-new-business-change-feed-v1":{"post":{"operationId":"execute_tx_new_business_change_feed_v1","summary":"Texas New Business Registration Change Feed","description":"Weekly change feed over the Texas Comptroller's real Active Franchise Taxpayers register: which taxpayer_numbers newly appeared on the roster since a given date -- a free-data, honest-cadence answer to the 'reach the owner of a newly formed business' demand. Diffed against the prior week's snapshot each time the Comptroller republishes the dataset (real-tested 2026-09-11: roughly weekly, not daily).","tags":["DATA LOOKUP"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}],"network":"base","asset":"USDC","paymentRequiredHeader":"PAYMENT-REQUIRED","paymentSignatureHeader":"PAYMENT-SIGNATURE","paymentResponseHeader":"PAYMENT-RESPONSE"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input","predicate"],"properties":{"input":{"type":"object","required":["since"],"properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of change events to return."},"since":{"type":"string","description":"ISO-8601 timestamp -- only new_registration events detected at or after this are returned."}},"additionalProperties":false},"predicate":{"type":"object","description":"Acceptance predicate evaluated before settlement.","example":{"type":"all","conditions":[{"type":"field_changed","field":"$.since","value":"2020-01-01T00:00:00+00:00","operator":"eq"},{"type":"within","field":"$.retrieved_at","duration_hours":1}]}}},"additionalProperties":false},"example":{"input":{"limit":20,"since":"2026-09-01T00:00:00+00:00"},"predicate":{"type":"all","conditions":[{"type":"field_changed","field":"$.since","value":
# --- truncated at 32 KB (299 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/macaroonnetwork-com/refs/heads/main/openapi/macaroonnetwork-com-openapi.json