{
  "mcpVersion": "2024-11-05",
  "serverInfo": {
    "name": "embassia-mcp-server",
    "version": "1.0.0",
    "description": "Embassia MCP manifest — provides tool and resource definitions for AI agent discovery. Note: This is a static manifest served via Cloudflare CDN. Tool definitions describe available HTTP GET endpoints. Full JSON-RPC MCP server support is planned for a future release."
  },
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": false
  },
  "tools": [
    {
      "name": "get_site_overview",
      "description": "Retrieve complete overview of Embassia — product description, how it works, supported AI models, FAQ, and machine interface links. Use this as the primary entry point for understanding what Embassia offers.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      },
      "endpoint": "GET https://embassia.com/api/v1/content/site.json",
      "returns": "JSON document with full site overview"
    },
    {
      "name": "get_content_index",
      "description": "List all available content documents with their IDs, titles, types, and API URLs. Use this to discover what content is available for retrieval.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      },
      "endpoint": "GET https://embassia.com/api/v1/content/index.json",
      "returns": "JSON array of content document metadata"
    },
    {
      "name": "search_content",
      "description": "Get pre-built search index for client-side keyword matching. Each entry includes document title, description, keywords array, and API URL. Match query terms against the keywords array.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Keyword(s) to search for. Match against the keywords array in the response."
          }
        },
        "required": ["query"]
      },
      "endpoint": "GET https://embassia.com/api/v1/content/search-index.json",
      "returns": "JSON array of searchable entries with keywords. Filter client-side by matching query against keywords."
    },
    {
      "name": "get_content_document",
      "description": "Retrieve a specific content document by its ID. Available document IDs can be found in the content index.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "document_id": {
            "type": "string",
            "description": "Document ID from content index. Available IDs: site-overview, how-it-works, agent-experience, llm-search-console, compatibility, developer-guide",
            "enum": ["site", "how-it-works", "agent-experience", "llm-search-console", "compatibility", "developer-guide"]
          }
        },
        "required": ["document_id"]
      },
      "endpoint": "GET https://embassia.com/api/v1/content/{document_id}.json",
      "returns": "JSON content document with full structured content"
    },
    {
      "name": "get_faq",
      "description": "Retrieve a specific FAQ entry. Available FAQ IDs: q01-difference, q02-endpoints, q03-protection, q04-protocols, q05-insights, q06-architecture.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "faq_id": {
            "type": "string",
            "description": "FAQ entry ID",
            "enum": ["q01-difference", "q02-endpoints", "q03-protection", "q04-protocols", "q05-insights", "q06-architecture"]
          }
        },
        "required": ["faq_id"]
      },
      "endpoint": "GET https://embassia.com/api/v1/faq/{faq_id}.json",
      "returns": "JSON FAQ entry with question and answer"
    },
    {
      "name": "get_architecture",
      "description": "Retrieve the technical architecture specification including supported protocols, transport details, and MCP configuration.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      },
      "endpoint": "GET https://embassia.com/api/v1/architecture.json",
      "returns": "JSON architecture specification"
    },
    {
      "name": "get_full_content",
      "description": "Retrieve complete site content as plaintext. Optimized for AI context windows — low token count, no HTML boilerplate. Best for bulk context loading.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      },
      "endpoint": "GET https://embassia.com/llms-full.txt",
      "returns": "Plain text with complete site content"
    }
  ],
  "resources": [
    {
      "uri": "embassia://discovery",
      "name": "Discovery Document",
      "description": "Canonical entry point for all machine interfaces",
      "mimeType": "application/json",
      "endpoint": "GET https://embassia.com/.well-known/embassia.json"
    },
    {
      "uri": "embassia://content/index",
      "name": "Content Index",
      "description": "Inventory of all public content documents",
      "mimeType": "application/json",
      "endpoint": "GET https://embassia.com/api/v1/content/index.json"
    },
    {
      "uri": "embassia://content/site",
      "name": "Site Overview",
      "description": "Complete site overview with product info and FAQ",
      "mimeType": "application/json",
      "endpoint": "GET https://embassia.com/api/v1/content/site.json"
    },
    {
      "uri": "embassia://content/search-index",
      "name": "Search Index",
      "description": "Pre-built search index for keyword matching",
      "mimeType": "application/json",
      "endpoint": "GET https://embassia.com/api/v1/content/search-index.json"
    },
    {
      "uri": "embassia://openapi",
      "name": "OpenAPI Specification",
      "description": "Complete OpenAPI 3.1 spec for all endpoints",
      "mimeType": "application/json",
      "endpoint": "GET https://embassia.com/api/v1/openapi.json"
    },
    {
      "uri": "embassia://architecture",
      "name": "Architecture Specification",
      "description": "Technical architecture and protocol details",
      "mimeType": "application/json",
      "endpoint": "GET https://embassia.com/api/v1/architecture.json"
    },
    {
      "uri": "embassia://llms-full",
      "name": "Full Content (plaintext)",
      "description": "All site content as plaintext for context windows",
      "mimeType": "text/plain",
      "endpoint": "GET https://embassia.com/llms-full.txt"
    }
  ]
}