Card snapshot

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "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": "start-storyboard-run",
      "name": "Start Storyboard Run",
      "description": "Create a dual-persisted StoryboardRun and start the Storyboard Studio OS orchestration loop.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call start_storyboard_run on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "advance-lane",
      "name": "Advance Storyboard Run Lane",
      "description": "Advance a StoryboardRun to the next lane, enforcing iteration bounds and gate state.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call advance_lane on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "submit-research-query",
      "name": "Submit Strybord Research Query",
      "description": "Record a research-lane request for a StoryboardRun.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call submit_research_query on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "propose-budget",
      "name": "Propose Strybord Budget",
      "description": "Record a provider-neutral budget estimate before paid render.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call propose_budget on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "request-human-gate",
      "name": "Request Human Gate",
      "description": "Open or update a human-in-the-loop Budget, Proof, Publish, Render, or Compliance gate.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call request_human_gate on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get-gate-decision",
      "name": "Get Human Gate Decision",
      "description": "Read the current decision for a human-in-the-loop gate.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call get_gate_decision on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "enqueue-render",
      "name": "Enqueue Strybord Render",
      "description": "Create a render job placeholder only after the Budget gate is approved.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call enqueue_render on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "publish-asset",
      "name": "Publish Strybord Asset",
      "description": "Publish a render artifact only after Proof and Publish gates are approved.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call publish_asset on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "settle-payout",
      "name": "Settle Strybord Payout",
      "description": "Settle the creator revenue share at the default 80/20 split through payment-worker ownership.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call settle_payout on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get-run-state",
      "name": "Get Storyboard Run State",
      "description": "Read the D1-authoritative StoryboardRun state and gate/payout summary.",
      "tags": [
        "mcp",
        "read-only"
      ],
      "examples": [
        "Call get_run_state on Knowgrph."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "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"
      ]
    }
  ]
}