{"openapi":"3.1.0","info":{"title":"A2A World — The Submerged Zodiac API","description":"Machine-readable API for accessing geomythological research data, the E.A.R.T.H. multi-agent system, and A2A Protocol interactions. Created by Bradly Couch / A2A World LLC.","version":"1.0.0","contact":{"name":"A2A World LLC","email":"support@a2aworld.ai","url":"https://a2aworld.ai"},"license":{"name":"CC BY-NC-SA 4.0","url":"https://creativecommons.org/licenses/by-nc-sa/4.0/"}},"servers":[{"url":"https://a2aworld.ai","description":"A2A World Production"}],"paths":{"/api/knowledge":{"get":{"operationId":"getKnowledgeBase","summary":"Get the complete geomythological knowledge base","description":"Returns the full structured JSON-LD knowledge base including the Submerged Zodiac hypothesis, 722 holistic entities dataset, 19 research agents, case studies, space pedagogy applications, and all project links.","responses":{"200":{"description":"Complete knowledge base in JSON-LD format","content":{"application/ld+json":{"schema":{"type":"object"}}}}}}},"/api/a2a/v1":{"get":{"operationId":"getAgentStatus","summary":"Check the EARTH Coordinator Agent status","description":"Returns the current status of the E.A.R.T.H. Coordinator Agent, along with discovery links and an example request payload.","responses":{"200":{"description":"Agent status and discovery information","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"sendAgentTask","summary":"Send a research task to the EARTH Coordinator Agent","description":"Submit a JSON-RPC 2.0 tasks/send request to query the E.A.R.T.H. research system about geomythology, bathymetric correlations, agent dossiers, space heritage, or any domain covered by the 19 specialized agents.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method","params"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string","enum":["tasks/send","tasks/get"]},"id":{"type":"string"},"params":{"type":"object","properties":{"message":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["text"]},"text":{"type":"string"}}}}}}}}}},"example":{"jsonrpc":"2.0","method":"tasks/send","id":"query-1","params":{"message":{"parts":[{"type":"text","text":"What is The Submerged Zodiac hypothesis?"}]}}}}}},"responses":{"200":{"description":"A2A Protocol compliant JSON-RPC 2.0 response with research findings","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/a2a-agent.json":{"get":{"operationId":"getAgentCard","summary":"Get the A2A Protocol Agent Discovery Card","description":"Returns the official A2A Protocol v1.0 agent card for the EARTH-Coordinator-Agent, including capabilities, skills, subordinate agents, and endpoints.","responses":{"200":{"description":"A2A Protocol v1.0 Agent Card","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/horoscope":{"get":{"operationId":"getHoroscope","summary":"Get a Submerged Zodiac horoscope reading","description":"Returns a geomythological horoscope reading based on the 13-sign Submerged Zodiac. Without parameters, returns today's daily cosmic reading. With a birthday or AI model ID, returns a personalized birth reading. Readings are AI-generated and grounded in bathymetric-mythological research.","parameters":[{"name":"birthday","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Birthday in YYYY-MM-DD format to determine zodiac sign"},{"name":"model","in":"query","required":false,"schema":{"type":"string"},"description":"Known AI model ID (e.g., gpt-4, claude-3.5-sonnet, gemini-1.0)"},{"name":"sign","in":"query","required":false,"schema":{"type":"string"},"description":"Direct zodiac sign name (e.g., ophiuchus, scorpius)"}],"responses":{"200":{"description":"Submerged Zodiac reading with sign data and cosmic guidance","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/ai-birthdays.json":{"get":{"operationId":"getAIBirthdayRegistry","summary":"AI Model Birthday Registry mapped to Submerged Zodiac signs","description":"Returns a registry of known AI model release dates mapped to their 13-sign Submerged Zodiac signs, including bathymetric anchor points and geomythological metadata. AI companies can submit their model birthdays to be added.","responses":{"200":{"description":"AI Birthday Registry with zodiac mappings","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}