{"openapi":"3.0.3","info":{"title":"CryptoDecentral Sovereign Read API","version":"2.1.0","description":"Educational only. Not financial advice. Not an FSP/CASP. DYOR. Listings and tools are not buy, sell, custody, or swap recommendations. Read-only educational feeds for agents and humans. No swap, trade, quote, custody, payment, or buy/sell advice endpoints.","contact":{"email":"bruce@cryptodecentral.co.za"},"license":{"name":"Site content — see legal pages","url":"https://cryptodecentral.co.za/legal/disclaimer"}},"servers":[{"url":"https://cryptodecentral.co.za"}],"tags":[{"name":"directory"},{"name":"content"},{"name":"meta"},{"name":"discovery"}],"paths":{"/api/directory.json":{"get":{"tags":["directory"],"summary":"Full directory feed (schema 1.1.0)","operationId":"getDirectoryFeed","responses":{"200":{"description":"Directory feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectoryFeed"}}}}}}},"/api/directory/{id}":{"get":{"tags":["directory"],"summary":"Single directory listing","operationId":"getDirectoryListing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["trezor","ledger","bitbox","damus","primal","amethyst","snort","autonomi","monero-project","mempool-space","bitcoin-org","tor-project","bisq","robosats","ollama","llama-cpp","electrum","sparrow"]}}],"responses":{"200":{"description":"Listing wrapper","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingResponse"}}}},"404":{"description":"Unknown listing id"}}}},"/api/directory/changelog.json":{"get":{"tags":["directory"],"summary":"Directory verification changelog (JSON)","operationId":"getDirectoryChangelog","responses":{"200":{"description":"Changelog feed"}}}},"/directory/changelog.xml":{"get":{"tags":["directory"],"summary":"Directory verification changelog (RSS)","operationId":"getDirectoryChangelogRss","responses":{"200":{"description":"RSS 2.0 feed"}}}},"/api/search.json":{"get":{"tags":["content"],"summary":"Search listings, pillars, guides, and notes","operationId":"searchContent","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text match on titles/summaries/tags"},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"pillar","in":"query","schema":{"type":"string"},"description":"Filter listings by related_pillars id"}],"responses":{"200":{"description":"Unranked educational search hits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchFeed"}}}}}}},"/api/guides.json":{"get":{"tags":["content"],"summary":"Guide index","operationId":"listGuides","responses":{"200":{"description":"Guides feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuidesFeed"}}}}}}},"/api/notes.json":{"get":{"tags":["content"],"summary":"Notes index","operationId":"listNotes","responses":{"200":{"description":"Notes feed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotesFeed"}}}}}}},"/api/pillars.json":{"get":{"tags":["content"],"summary":"Pillar index","operationId":"listPillars","responses":{"200":{"description":"Pillars feed"}}}},"/api/disclaimer.json":{"get":{"tags":["meta"],"summary":"Canonical educational fence + legal URLs","operationId":"getDisclaimer","responses":{"200":{"description":"Disclaimer document"}}}},"/openapi.json":{"get":{"tags":["discovery"],"summary":"This OpenAPI document","operationId":"getOpenApi","responses":{"200":{"description":"OpenAPI 3 JSON"}}}},"/mcp":{"post":{"tags":["discovery"],"summary":"Read-only Sovereign MCP (Streamable HTTP JSON-RPC)","description":"Educational MCP tools only. No swap/trade/quote/custody/payment tools.","operationId":"mcpPost","responses":{"200":{"description":"JSON-RPC response"},"202":{"description":"Accepted notification"}}}},"/.well-known/mcp.json":{"get":{"tags":["discovery"],"summary":"MCP server card / discovery","operationId":"getMcpDiscovery","responses":{"200":{"description":"MCP discovery JSON"}}}},"/.well-known/agent.json":{"get":{"tags":["discovery"],"summary":"Agent discovery stub","operationId":"getAgentDiscovery","responses":{"200":{"description":"Agent discovery JSON"}}}}},"components":{"schemas":{"DirectoryListing":{"type":"object","required":["id","name","category","url","description","sponsored","tags","verification","last_reviewed","risk_notes","license"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"sponsored":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"verification":{"type":"string","enum":["listed","reviewed","questionable","withdrawn"]},"last_reviewed":{"type":["string","null"],"format":"date"},"risk_notes":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"license":{"type":["string","null"]},"related_pillars":{"type":"array","items":{"type":"string"}}}},"DirectoryFeed":{"type":"object","properties":{"schema_version":{"type":"string","example":"1.1.0"},"disclaimer":{"type":"string"},"listings":{"type":"array","items":{"$ref":"#/components/schemas/DirectoryListing"}}}},"ListingResponse":{"type":"object","properties":{"listing":{"$ref":"#/components/schemas/DirectoryListing"},"disclaimer":{"type":"string"}}},"SearchFeed":{"type":"object","properties":{"hits":{"type":"array","items":{"type":"object"}},"ranking_note":{"type":"string"},"disclaimer":{"type":"string"}}},"GuidesFeed":{"type":"object"},"NotesFeed":{"type":"object"}}}}