Knowgrph Agent

{
  "name": "Knowgrph Agent",
  "description": "Agent-readable discovery, published-document retrieval, and WebMCP-ready metadata surface for Knowgrph.",
  "version": "0.1.0",
  "provider": {
    "organization": "airvio / joohwee",
    "url": "https://airvio.co/knowgrph/"
  },
  "url": "https://airvio.co/knowgrph/mcp",
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "url": "https://airvio.co/knowgrph/mcp",
      "protocolBinding": "JSONRPC",
      "transportProtocol": "JSONRPC",
      "description": "Primary machine interface for read-only discovery and source-file document access."
    },
    {
      "url": "https://airvio.co/api/storage/source-files",
      "protocolBinding": "HTTP+JSON/REST",
      "transportProtocol": "HTTP+JSON/REST",
      "description": "Published source-files index and storage-backed document read surface."
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain",
    "text/markdown",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "text/markdown",
    "application/json"
  ],
  "skills": [
    {
      "id": "search",
      "name": "Search Knowgrph Source Files",
      "description": "Use this when an MCP host needs to search published Knowgrph Source Files and return stable document IDs for the `fetch` tool. Call this first for OpenAI Deep Research-style retrieval, Claude, Qwen Code, Kimi CLI, BytePlus ModelArk, and generic MCP clients.",
      "tags": [
        "mcp",
        "search",
        "source-files",
        "read-only"
      ],
      "examples": [
        "Search Knowgrph Source Files for renderer architecture."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "fetch",
      "name": "Fetch Knowgrph Source File",
      "description": "Use this when an MCP host needs the complete published Knowgrph Source File for an ID returned by `search`. Returns markdown as both `content` and `text` for OpenAI, Claude, Qwen Code, Kimi CLI, BytePlus ModelArk, and generic MCP clients.",
      "tags": [
        "mcp",
        "fetch",
        "source-files",
        "markdown",
        "read-only"
      ],
      "examples": [
        "Fetch the Knowgrph Source File id returned by search."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "text/markdown",
        "application/json"
      ]
    },
    {
      "id": "list-source-files",
      "name": "List Source Files",
      "description": "Use this when an MCP host needs the published Knowgrph Source Files index as markdown.",
      "tags": [
        "mcp",
        "discovery",
        "source-files",
        "read-only"
      ],
      "examples": [
        "List the published Knowgrph Source Files."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "text/markdown",
        "application/json"
      ]
    },
    {
      "id": "read-source-file",
      "name": "Read Source File",
      "description": "Use this when an MCP host knows a published Knowgrph canonical path and needs that Editor Workspace markdown content. Defaults to the canonical docs workspace when workspaceId is omitted.",
      "tags": [
        "mcp",
        "read",
        "markdown",
        "workspace"
      ],
      "examples": [
        "Read the published source file for docs/getting-started.md."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "text/markdown",
        "application/json"
      ]
    },
    {
      "id": "read-shared-document",
      "name": "Read Shared Document",
      "description": "Use this when an MCP host has a Knowgrph share token or public Knowgrph share/document URL and needs the published markdown content.",
      "tags": [
        "mcp",
        "read",
        "shared-document",
        "markdown"
      ],
      "examples": [
        "Read the Knowgrph shared document behind this share URL."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "text/markdown",
        "application/json"
      ]
    },
    {
      "id": "inspect-shared-document-structure",
      "name": "Inspect Shared Document Structure",
      "description": "Use this when an MCP host has a Knowgrph share token or public Knowgrph share/document URL and needs frontmatter/body structure without mutating the document.",
      "tags": [
        "mcp",
        "inspect",
        "shared-document",
        "structure"
      ],
      "examples": [
        "Inspect the structure of this Knowgrph shared document."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "inspect-agent-surface",
      "name": "Inspect Agent Surface",
      "description": "Use this when an MCP Apps-capable host or generic MCP client needs to inspect Knowgrph agent-ready discovery, MCP Apps readiness, OpenAPI, and skill metadata.",
      "tags": [
        "mcp",
        "agent-ready",
        "discovery",
        "metadata"
      ],
      "examples": [
        "Show the Knowgrph agent discovery metadata."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    }
  ]
}