MCP

The Blankstate MCP server exposes the IBF API as MCP tools. Any MCP-compatible host (Claude Desktop, Continue, custom agent runtimes) can dive into a World and pull SGM readings without custom HTTP code. Agents are proven inside Worlds before touching a live workflow. MCP is how they get there.

Install

npx @blankstate/mcp install

Or add manually to your MCP host configuration:

{
  "mcpServers": {
    "blankstate": {
      "command": "npx",
      "args": ["@blankstate/mcp"],
      "env": { "BKS_KEY": "your_api_key" }
    }
  }
}

Available tools

Tool	Description
`bks_sense`	Sense content with a Protocol or Blueprint
`bks_protocols_list`	List available Protocols
`bks_protocol_get`	Get Protocol definition
`bks_signature_get`	Get a Signature for an actant
`bks_usage`	Get current ICS usage

Usage in an agent

Once the MCP server is running, the agent can call sensing tools naturally. Example prompt to an agent:

Sense this advisory call transcript with the advisory-quality Blueprint and summarise the fidelity and key metamarkers.

The agent calls bks_sense with the transcript and Blueprint id, receives the metamarker set, and composes the summary.

Streaming

bks_sense supports streaming responses. Metamarkers are emitted as they are produced, enabling real-time feedback loops inside long-running agent interactions.

Overview

Packages

Install

Available tools

Usage in an agent

Streaming

​Install

​Available tools

​Usage in an agent

​Streaming

Install

Available tools

Usage in an agent

Streaming