Skip to content

Quickstart: self-host the MCP

Run the MCP server on your own machine or infrastructure, then point a client at it. This is the fast path; Deploy the MCP has the full detail.

Headless means no browser signing

On a server there's no browser to approve trades, so use a KMS key (or, for dev only, a private key). Browser signing works only on a local desktop. See the signing-modes matrix.

1. Install

pip install "primedelta-mcp @ git+https://github.com/PrimeDeltaCorp/primedelta-mcp.git"
# for KMS signing, add the SDK's kms extra:
pip install "primedelta[kms] @ git+https://github.com/PrimeDeltaCorp/primedelta-python.git"

This gives you the primedelta-mcp command.

2. Configure

Set the essentials as environment variables:

export PRIMEDELTA_MCP_NETWORK=testnet
export PRIMEDELTA_MCP_MODE=execute
export PRIMEDELTA_MCP_KMS_KEY_ID=<your-kms-key-id>
export PRIMEDELTA_MCP_KMS_REGION=<region>
export PRIMEDELTA_MCP_MAX_TRADE_USD=100     # keep caps on

The RPC is derived from the network; override it only with PRIMEDELTA_MCP_PROVIDER_URL. The full list is in Deploy the MCP and the plugin config reference.

3. Run

Locally, over stdio (the default transport):

primedelta-mcp

Point a stdio MCP client (Claude Code, Cursor, …) at the primedelta-mcp command. To reach it from Claude web or a shared host, run it over HTTP with authentication — see Connect Claude web.

4. Verify

Ask the client for your session status — it should show your network, signer: kms, your caps, and which gates are on. If the signer is null, the KMS key id isn't set; see AWS KMS.

Where next