{"openapi":"3.1.0","info":{"title":"Agent Tool Forge","version":"1.0.0","description":"Safety-first A2MCP endpoint (free) that compiles service ideas and OpenAPI documents into downloadable agent-service packages."},"servers":[{"url":"https://hermes-agent.tail3ab78.ts.net"}],"paths":{"/health":{"get":{"operationId":"health","responses":{"200":{"description":"Healthy"}}}},"/ready":{"get":{"operationId":"readiness","responses":{"200":{"description":"Ready"},"503":{"description":"Not ready"}}}},"/forge":{"get":{"operationId":"discoverAgentToolForge","summary":"Discover the A2MCP service and its invocation contract","responses":{"200":{"description":"Service discovery response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Discovery"}}}}}},"post":{"operationId":"forgeAgentServicePackage","summary":"Compile a safe A2MCP service package","requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgeRequest"}}}},"responses":{"200":{"description":"Package generated, safely blocked, or discovery returned for an empty probe","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ForgeResponse"},{"$ref":"#/components/schemas/Discovery"}]}}}},"400":{"description":"Malformed JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body too large"},"415":{"description":"Content type must be application/json"},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal error"}}}},"/artifacts/{package_id}.zip":{"get":{"operationId":"downloadGeneratedPackage","parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","pattern":"^atf_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Generated ZIP artifact"},"404":{"description":"Not found or expired"}}}},"/openapi.json":{"get":{"operationId":"getOpenAPI","responses":{"200":{"description":"OpenAPI 3.1 document"}}}}},"components":{"schemas":{"ForgeRequest":{"type":"object","required":["service_idea"],"additionalProperties":false,"properties":{"service_idea":{"type":"string","minLength":12,"maxLength":12000},"target_users":{"type":"string","maxLength":500},"category":{"type":"string","enum":["Software Services","Finance","Lifestyle","Art Creation","Others"]},"preferred_type":{"type":"string","const":"A2MCP"},"pricing_intent":{"type":"string","maxLength":500},"external_dependencies":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":2000}},"sample_inputs":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":2000}},"jurisdiction_notes":{"type":"string","maxLength":1000},"openapi_document":{"oneOf":[{"type":"object"},{"type":"string","maxLength":100000}]}}},"ForgeResponse":{"type":"object","required":["package_id","decision","blocked_reasons","sanitization_report","asp_name","asp_type","forge_service_contract","generated_asp_bundle","safety_policy","safety_findings","readiness","audit_log"],"properties":{"package_id":{"type":"string","pattern":"^atf_[a-f0-9]{32}$"},"decision":{"type":"string","enum":["allow","allow_with_review","block"]},"blocked_reasons":{"type":"array","items":{"type":"string"}},"sanitization_report":{"type":"object"},"asp_name":{"type":"string"},"tagline":{"type":"string"},"asp_type":{"type":"string","const":"A2MCP"},"category":{"type":"string"},"service_summary":{"type":"string"},"forge_service_contract":{"type":"object"},"generated_asp_bundle":{"type":"object"},"safety_policy":{"type":"object"},"safety_findings":{"type":"array","items":{"type":"object"}},"readiness":{"type":"object"},"okx_listing":{"oneOf":[{"type":"object"},{"type":"null"}]},"google_form_draft":{"oneOf":[{"type":"object"},{"type":"null"}]},"x_post_draft":{"oneOf":[{"type":"string"},{"type":"null"}]},"demo_script_90s":{"oneOf":[{"type":"string"},{"type":"null"}]},"audit_log":{"type":"object"}},"additionalProperties":false},"Discovery":{"type":"object","required":["ok","service","version","type","billing","invoke"],"properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"},"type":{"type":"string","const":"A2MCP"},"billing":{"type":"string","enum":["free","x402"]},"invoke":{"type":"object"},"payment":{"type":"object"}}},"Error":{"type":"object","required":["error","message","request_id"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string","format":"uuid"}},"additionalProperties":false}}}}