> ## Documentation Index
> Fetch the complete documentation index at: https://doc.blankstate.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Agent-native access to Worlds and Protocols via the Model Context Protocol.

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

```bash theme={null}
npx @blankstate/mcp install
```

Or add manually to your MCP host configuration:

```json theme={null}
{
  "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.