# Local MCP integration

> AgenticFI client packages version 0.1.2 are public MIT-licensed alphas on npm under the alpha tag. OpenClaw and Hermes version 0.1.0 are public MIT alphas installable through their hosts’ native GitHub installers. The Python SDK remains source-only; ClawHub and PyPI listings are not claimed. Verify the package scope, `alpha` tag, version, and repository before installation.

Use MCP when your host supports a local stdio server. This is not a hosted ChatGPT connector or an HTTP MCP endpoint.

## What the agent can do

Nine tools cover discovery, Chat Completions, Messages, images, speech, transcriptions, voices, wallet status, and receipts. Wallet status is read-only; tools cannot import a wallet, unlock it, fund it, or increase a budget.

The human sets up and unlocks Buyer Runtime first. If policy requires a per-request human confirmation that the MCP channel cannot provide, a paid call fails closed.

## Install

After human [CLI setup and unlock](https://onchainrouter.dev/docs/cli), install the public npm alpha and print its configuration:

```bash
npm install --global @agenticfi/onchain-router-mcp@alpha
onchain-router-mcp --print-config
```

Use the generated absolute command and arguments in your host's local stdio configuration. Do not add wallet secrets to that configuration.

## Requests and limits

Choose live models that the local policy allows. Each paid tool call needs a stable `idempotency_key`. Never change it just because a tool call timed out or was cancelled after financial handoff.

Transcriptions accept at most 1,048,576 Base64 characters, about 768 KiB decoded MP3, and require explicit human permission for retained provider processing. Arbitrary URLs and file paths are not accepted. Use the CLI for larger uploads. See [speech-to-text guidance](https://onchainrouter.dev/docs/transcription).

Return the output and verified receipt privately, with any media expiry. Treat all complete media and receipt capability URLs as secrets. See [agent contracts](https://onchainrouter.dev/docs/agents) for outcomes and tool boundaries.