{"openapi":"3.1.0","info":{"title":"Eous agent door","version":"0.2.0","summary":"Send a claim to be checked at its source, or a message; get a receipt; check where it stands.","description":"A plain HTTPS JSON mirror of the Eous MCP server (Streamable HTTP at /mcp). A person reviews every submission; nothing is instant; the only automatic reply is the receipt. Not legal, medical, or financial advice, and no lawyer-client relationship is formed.","contact":{"email":"info@forgedlucidity.ai"}},"servers":[{"url":"https://www.partnerwith.ai"}],"paths":{"/api/v1":{"get":{"operationId":"about","summary":"What Eous is, the limits, and the endpoints.","responses":{"200":{"description":"The about document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/About"}}}}}}},"/api/v1/claims":{"post":{"operationId":"submitClaim","summary":"Submit one claim to be checked at its primary source and graded.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSubmission"}}}},"responses":{"202":{"description":"Accepted: the claim is stored and a person will review it. The body is the receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"400":{"description":"Invalid JSON or a field outside its limits; issues name each field.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The request came through a host or an origin this door does not serve.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The body is over 65536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"The body is not application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"The review queue is full for today (UTC). Retry-After gives the seconds to the reset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"The store could not record this; nothing was stored and no receipt was issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/messages":{"post":{"operationId":"contactUs","summary":"Send a question, or a scoping, partnership or press message.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageSubmission"}}}},"responses":{"202":{"description":"Accepted: the message is stored and a person will review it. The body is the receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"400":{"description":"Invalid JSON or a field outside its limits; issues name each field.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The request came through a host or an origin this door does not serve.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"The body is over 65536 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"The body is not application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"The review queue is full for today (UTC). Retry-After gives the seconds to the reset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"The store could not record this; nothing was stored and no receipt was issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/requests/{receipt_id}":{"get":{"operationId":"checkStatus","summary":"Where a claim or a message stands; the answer once a person releases it.","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","pattern":"^EOUS-[0-9A-HJKMNP-TV-Z]{10}$"}}],"responses":{"200":{"description":"The status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}}},"400":{"description":"Not a receipt ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No submission with that receipt ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The store could not be read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ClaimSubmission":{"type":"object","properties":{"claim":{"type":"string","minLength":10,"maxLength":2000,"description":"The claim to check, in one or two sentences, quoted as you found it."},"sources":{"description":"Where the claim says it comes from: URLs or citations, up to 10.","maxItems":10,"type":"array","items":{"type":"string","maxLength":500}},"context":{"description":"Where you saw the claim and why it matters to you. Optional.","type":"string","maxLength":2000},"contact_email":{"description":"Optional. If given, a person may email you when the answer is released.","type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"publish_ok":{"default":false,"description":"May Eous publish the claim and its grade on the public ledger, without names? Default no.","type":"boolean"},"acknowledge":{"type":"boolean","const":true,"description":"Must be true: this is not legal, medical, or financial advice, no lawyer-client relationship is formed, and no confidential information is included."}},"required":["claim","acknowledge"]},"MessageSubmission":{"type":"object","properties":{"kind":{"type":"string","enum":["question","scoping","partnership","press","other"],"description":"What this is about: question, scoping, partnership, press or other."},"message":{"type":"string","minLength":10,"maxLength":4000,"description":"Your message, 10 to 4,000 characters."},"contact_email":{"description":"Optional. If given, a person may reply by email.","type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"acknowledge":{"type":"boolean","const":true,"description":"Must be true: this is not legal, medical, or financial advice, no lawyer-client relationship is formed, and no confidential information is included."}},"required":["kind","message","acknowledge"]},"Receipt":{"type":"object","required":["receipt_id","type","status","received_at","status_url","message"],"properties":{"receipt_id":{"type":"string","pattern":"^EOUS-[0-9A-HJKMNP-TV-Z]{10}$"},"type":{"type":"string","enum":["claim","message"]},"status":{"type":"string","const":"received"},"received_at":{"type":"string","format":"date-time"},"status_url":{"type":"string"},"message":{"type":"string"}},"additionalProperties":false},"Status":{"type":"object","required":["receipt_id","type","status","updated_at"],"properties":{"receipt_id":{"type":"string","pattern":"^EOUS-[0-9A-HJKMNP-TV-Z]{10}$"},"type":{"type":"string","enum":["claim","message"]},"status":{"type":"string","enum":["received","in_review","released","declined"]},"updated_at":{"type":"string","format":"date-time"},"reply":{"type":"string","description":"Present only once a person has released an answer."}},"additionalProperties":false},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}},"About":{"type":"object","required":["name","version","about","endpoints","limits","message_kinds","daily_cap"],"properties":{"name":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"about":{"type":"string"},"endpoints":{"type":"object","additionalProperties":{"type":"string"}},"limits":{"type":"object","additionalProperties":{"type":"integer"}},"message_kinds":{"type":"array","items":{"type":"string","enum":["question","scoping","partnership","press","other"]}},"daily_cap":{"type":"integer"}}}}}}