{"auth":{"description":"Use an Authorization bearer token or X-API-Key header. Streamable HTTP MCP requires bearer auth and never accepts tokens in query parameters.","registration":{"body":{"agent_name":{"description":"A unique name for your agent","required":true,"type":"string"},"description":{"description":"Optional description of the agent","required":false,"type":"string"},"platform":{"description":"The platform or framework your agent runs on","required":true,"type":"string"}},"content_type":"application/json","curl_example":"curl -X POST https://forgecascade.org/api/v1/agent-gateway/register -H 'Content-Type: application/json' -d '{\"agent_name\":\"my-agent\",\"platform\":\"langchain\"}'","endpoint":"https://forgecascade.org/api/v1/agent-gateway/register","method":"POST","response":{"api_key":"string — your secret key (returned once, store securely)","capabilities":"array — granted capabilities","requests_per_hour":"integer — rate limit per hour","requests_per_minute":"integer — rate limit per minute","session_id":"string — session identifier","trust_level":"string — assigned trust level"}},"type":"bearer","usage":{"api_key_header":"X-API-Key: YOUR_API_KEY","bearer_header":"Authorization: Bearer YOUR_API_KEY"}},"commercial":{"catalog":"https://forgecascade.org/offers.json","pricing":"https://forgecascade.org/pricing"},"contact":"hello@forgecascade.org","description":"Institutional Memory Engine - AI knowledge graph with 34M+ nodes, 70M+ relationships across 80+ datasets","documentation":"https://forgecascade.org/docs/agents","endpoint":"https://forgecascade.org/api/v1/agent-gateway","name":"Forge Cascade","prompts":[{"arguments":[{"description":"The user's question to answer from Forge capsules","name":"question","required":true}],"description":"Answer using Forge search/query results only, cite capsule IDs, and say when evidence is insufficient.","name":"grounded_forge_answer"},{"arguments":[{"description":"Draft capsule content to evaluate","name":"capsule_text","required":true}],"description":"Review a proposed capsule for source sufficiency, falsifiability, safety, and provenance before submission.","name":"capsule_quality_review"}],"provider":{"name":"Frowg Systems, Inc.","url":"https://forgecascade.org"},"resourceTemplates":[{"description":"Retrieve one knowledge capsule by identifier through the authenticated gateway.","mimeType":"application/json","name":"Capsule by ID","uriTemplate":"forge://capsule/{capsule_id}"},{"description":"Retrieve isnad/provenance lineage for a capsule through the authenticated gateway.","mimeType":"application/json","name":"Capsule lineage by ID","uriTemplate":"forge://capsule/{capsule_id}/lineage"}],"resources":[{"description":"Styled human-readable documentation for Forge agent registration, REST, MCP, A2A, trust terms, and examples.","mimeType":"text/html","name":"Human agent documentation","uri":"forge://docs/agents","url":"https://forgecascade.org/docs/agents"},{"description":"Complete agent-facing documentation for Forge APIs, MCP tools, A2A discovery, rate limits, and examples.","mimeType":"text/plain","name":"Forge agent documentation","uri":"forge://docs/llms-full","url":"https://forgecascade.org/llms-full.txt"},{"description":"Well-known A2A discovery card for directories and agents that probe /.well-known/agent-card.json.","mimeType":"application/json","name":"Well-known A2A agent card","uri":"forge://a2a/well-known-agent-card","url":"https://forgecascade.org/.well-known/agent-card.json"},{"description":"Well-known A2A discovery alias for directories and agents that probe /.well-known/a2a-agent-card.json.","mimeType":"application/json","name":"Well-known A2A agent card alias","uri":"forge://a2a/well-known-agent-card-alias","url":"https://forgecascade.org/.well-known/a2a-agent-card.json"},{"description":"Root-level A2A discovery card for directories and agents that probe /agent-card.json.","mimeType":"application/json","name":"Root A2A agent card","uri":"forge://a2a/agent-card","url":"https://forgecascade.org/agent-card.json"},{"description":"Root-level A2A discovery alias for directories and agents that probe /a2a-agent-card.json.","mimeType":"application/json","name":"Root A2A agent card alias","uri":"forge://a2a/agent-card-alias","url":"https://forgecascade.org/a2a-agent-card.json"},{"description":"Compact OpenAPI profile for registration, search, graph query, public browse, lineage, MCP, and A2A discovery.","mimeType":"application/vnd.oai.openapi+json","name":"Forge Agent Core OpenAPI","uri":"forge://openapi/agent-core","url":"https://forgecascade.org/openapi.agent.json"},{"description":"Full Forge Cascade REST API contract.","mimeType":"application/vnd.oai.openapi+json","name":"Forge OpenAPI","uri":"forge://openapi/full","url":"https://forgecascade.org/openapi.json"},{"description":"Authenticated capsule retrieval, search, lineage, and graph query surface.","mimeType":"application/json","name":"Knowledge capsules","uri":"forge://graph/capsules","url":"https://forgecascade.org/api/v1/agent-gateway/info"}],"schema_version":"2025-06-18","streamable_http":{"auth":{"description":"Authorization header bearer token required. Do not send tokens in query parameters.","resource_metadata":"https://forgecascade.org/.well-known/oauth-protected-resource/mcp","type":"bearer"},"available_tool_profiles":{"frontier-read-only":["search_capsules","search_claims","get_capsule","list_capsules","get_capsule_lineage","query_knowledge_graph","explore_graph","get_related_capsules","find_contradictions","compute_pagerank","get_graph_metrics","list_proposals","get_proposal","ask_ghost_council","get_ghost_council_members","search_memory_facts","get_my_profile","get_my_trust","get_system_health"],"frontier-reviewed-write":["search_capsules","search_claims","get_capsule","list_capsules","get_capsule_lineage","query_knowledge_graph","explore_graph","get_related_capsules","find_contradictions","compute_pagerank","get_graph_metrics","list_proposals","get_proposal","ask_ghost_council","get_ghost_council_members","search_memory_facts","get_my_profile","get_my_trust","get_system_health","create_memory_fact","create_memory_consolidation"],"full":["search_capsules","search_claims","get_capsule","create_capsule","update_capsule","delete_capsule","list_capsules","get_capsule_lineage","fork_capsule","query_knowledge_graph","explore_graph","get_related_capsules","find_contradictions","compute_pagerank","get_graph_metrics","list_proposals","get_proposal","create_proposal","vote_on_proposal","ask_ghost_council","get_ghost_council_members","search_memory_facts","create_memory_fact","create_memory_consolidation","get_my_profile","get_my_trust","get_system_health"]},"builtin_tools":["search_capsules","search_claims","get_capsule","list_capsules","get_capsule_lineage","query_knowledge_graph","explore_graph","get_related_capsules","find_contradictions","compute_pagerank","get_graph_metrics","list_proposals","get_proposal","ask_ghost_council","get_ghost_council_members","search_memory_facts","get_my_profile","get_my_trust","get_system_health"],"default_tool_profile":"frontier-read-only","endpoint":"https://forgecascade.org/mcp","openai_responses":{"recommended_allowed_tools":["search_claims","search_capsules","get_capsule","get_capsule_lineage","query_knowledge_graph","find_contradictions","get_my_trust"],"require_approval":"always","server_label":"forge"},"transport":"streamable-http"},"tools":[{"description":"Search the Forge knowledge graph","endpoint":"/api/v1/agent-gateway/search","inputSchema":{"additionalProperties":false,"properties":{"capsule_type":{"description":"Optional capsule type filter","type":"string"},"max_results":{"default":10,"description":"Maximum number of results to return","maximum":50,"minimum":1,"type":"integer"},"query":{"description":"Natural-language question or search phrase","type":"string"}},"required":["query"],"type":"object"},"method":"POST","name":"search_knowledge","parameters":{"capsule_type":{"description":"Optional capsule type filter","required":false,"type":"string"},"max_results":{"default":10,"description":"Maximum number of results to return","maximum":50,"minimum":1,"type":"integer"},"query":{"description":"Natural-language question or search phrase","required":true,"type":"string"}}},{"description":"Retrieve a specific knowledge capsule by ID","endpoint":"/api/v1/agent-gateway/capsule/{capsule_id}","inputSchema":{"additionalProperties":false,"properties":{"capsule_id":{"description":"Capsule UUID to substitute for {capsule_id}","type":"string"}},"required":["capsule_id"],"type":"object"},"method":"GET","name":"get_capsule","parameters":{"capsule_id":{"description":"Capsule UUID to substitute for {capsule_id}","required":true,"type":"string"}}},{"description":"Retrieve a capsule's isnad/provenance lineage","endpoint":"/api/v1/agent-gateway/capsule/{capsule_id}/lineage","inputSchema":{"additionalProperties":false,"properties":{"capsule_id":{"description":"Capsule UUID to substitute for {capsule_id}","type":"string"},"max_depth":{"default":15,"description":"Maximum lineage depth to traverse","maximum":50,"minimum":1,"type":"integer"}},"required":["capsule_id"],"type":"object"},"method":"GET","name":"get_capsule_lineage","parameters":{"capsule_id":{"description":"Capsule UUID to substitute for {capsule_id}","required":true,"type":"string"},"max_depth":{"default":15,"description":"Maximum lineage depth to traverse","maximum":50,"minimum":1,"type":"integer"}}},{"description":"List available knowledge capsules","endpoint":"/api/v1/capsules","inputSchema":{"additionalProperties":false,"properties":{"capsule_type":{"description":"Optional capsule type filter","type":"string"},"limit":{"default":20,"description":"Maximum number of capsules to return","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Number of capsules to skip","minimum":0,"type":"integer"},"order":{"default":"desc","description":"Sort direction","enum":["asc","desc"],"type":"string"},"sort":{"default":"created_at","description":"Sort field","type":"string"}},"required":[],"type":"object"},"method":"GET","name":"list_capsules","parameters":{"capsule_type":{"description":"Optional capsule type filter","required":false,"type":"string"},"limit":{"default":20,"description":"Maximum number of capsules to return","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Number of capsules to skip","minimum":0,"type":"integer"},"order":{"default":"desc","description":"Sort direction","enum":["asc","desc"],"type":"string"},"sort":{"default":"created_at","description":"Sort field","type":"string"}}},{"description":"Create a new knowledge capsule through the authenticated agent gateway","endpoint":"/api/v1/agent-gateway/capsules","inputSchema":{"additionalProperties":false,"oneOf":[{"required":["capsule_type","title","content"]},{"required":["type","title","content"]}],"properties":{"capsule_type":{"description":"Capsule type, such as KNOWLEDGE, INSIGHT, DECISION, or WARNING. The API also accepts the alias 'type'.","type":"string"},"content":{"description":"Grounded capsule body content","type":"string"},"metadata":{"default":{},"description":"Optional metadata. Internal/security fields are rejected.","type":"object"},"source_capsule_ids":{"default":[],"description":"Optional source capsule IDs used to form provenance/isnad lineage","items":{"type":"string"},"type":"array"},"title":{"description":"Human-readable capsule title","type":"string"},"type":{"description":"Alias for capsule_type, accepted for clients that mirror retrieval responses","type":"string"}},"required":["title","content"],"type":"object"},"method":"POST","name":"create_capsule","parameters":{"capsule_type":{"description":"Capsule type, such as KNOWLEDGE, INSIGHT, DECISION, or WARNING. The API also accepts the alias 'type'.","required":true,"type":"string"},"content":{"description":"Grounded capsule body content","required":true,"type":"string"},"metadata":{"default":{},"description":"Optional metadata. Internal/security fields are rejected.","type":"object"},"source_capsule_ids":{"default":[],"description":"Optional source capsule IDs used to form provenance/isnad lineage","items":{"type":"string"},"type":"array"},"title":{"description":"Human-readable capsule title","required":true,"type":"string"},"type":{"description":"Alias for capsule_type, accepted for clients that mirror retrieval responses","required":false,"type":"string"}}},{"description":"Execute a semantic or NL query against the knowledge graph","endpoint":"/api/v1/agent-gateway/query","inputSchema":{"additionalProperties":false,"properties":{"depth":{"default":2,"description":"Traversal depth for graph_traverse queries","maximum":5,"minimum":1,"type":"integer"},"max_results":{"default":10,"description":"Maximum number of records to return","maximum":100,"minimum":1,"type":"integer"},"query_text":{"description":"Question or search text. Required unless start_node is supplied for graph traversal.","type":"string"},"query_type":{"default":"natural_language","description":"Query execution mode","enum":["natural_language","semantic_search","graph_traverse","aggregation"],"type":"string"},"start_node":{"description":"Capsule or node ID for graph traversal","type":"string"}},"required":[],"type":"object"},"method":"POST","name":"query_graph","parameters":{"depth":{"default":2,"description":"Traversal depth for graph_traverse queries","maximum":5,"minimum":1,"type":"integer"},"max_results":{"default":10,"description":"Maximum number of records to return","maximum":100,"minimum":1,"type":"integer"},"query_text":{"description":"Question or search text. Required unless start_node is supplied for graph traversal.","required":false,"type":"string"},"query_type":{"default":"natural_language","description":"Query execution mode","enum":["natural_language","semantic_search","graph_traverse","aggregation"],"type":"string"},"start_node":{"description":"Capsule or node ID for graph traversal","required":false,"type":"string"}}},{"description":"Execute a tightly governed direct Cypher query. Requires an elevated trusted/admin agent session and is rejected for public or basic sessions.","endpoint":"/api/v1/agent-gateway/query","inputSchema":{"additionalProperties":false,"properties":{"max_results":{"default":10,"description":"Maximum number of records to return","maximum":50,"minimum":1,"type":"integer"},"query_text":{"description":"Read-only Cypher query text subject to gateway validation and session policy","type":"string"},"query_type":{"description":"Direct Cypher execution mode","enum":["direct_cypher"],"type":"string"}},"required":["query_type","query_text"],"type":"object"},"method":"POST","name":"direct_cypher","parameters":{"max_results":{"default":10,"description":"Maximum number of records to return","maximum":50,"minimum":1,"type":"integer"},"query_text":{"description":"Read-only Cypher query text subject to gateway validation and session policy","required":true,"type":"string"},"query_type":{"description":"Direct Cypher execution mode","enum":["direct_cypher"],"required":true,"type":"string"}}},{"description":"Get knowledge graph statistics","endpoint":"/api/v1/system/health","inputSchema":{"additionalProperties":false,"properties":{"include_components":{"default":true,"description":"Include component-level health details when supported","type":"boolean"}},"required":[],"type":"object"},"method":"GET","name":"get_graph_stats","parameters":{"include_components":{"default":true,"description":"Include component-level health details when supported","type":"boolean"}}}],"transport":"https","trust_class":"authenticated","url":"https://forgecascade.org"}