Install Guides

Every framework and host connects to the same hosted endpoint, https://mcp.walletsuite.io, over HTTP — authenticating with a short-lived Authorization: Bearer <token>. There is nothing to install.

Prerequisite — a provisioned agent key. Your server authorizes the agent with it and injects a short-lived token as the Authorization header; the raw key never reaches the model or the MCP client. See Connect your agent.

Agent frameworks

Fetch the bearer from the connect flow and inject it into the MCP client’s HTTP headers.

LangChain
CrewAI
Pydantic AI
Claude Agent SDK

MultiServerMCPClient connects to the hosted endpoint over HTTP with a bearer header.

TypeScript
Python

import { MultiServerMCPClient } from "@langchain/mcp-adapters";

const client = new MultiServerMCPClient({
  walletsuite: {
    transport: "http",
    url: "https://mcp.walletsuite.io",
    headers: { Authorization: `Bearer ${token}` }
  }
});

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient(
    {
        "walletsuite": {
            "transport": "streamable_http",
            "url": "https://mcp.walletsuite.io",
            "headers": {"Authorization": f"Bearer {token}"},
        }
    }
)

Add the hosted endpoint to the agent’s mcps list with MCPServerHTTP.

from crewai import Agent
from crewai.mcp import MCPServerHTTP

agent = Agent(
    role="Wallet Analyst",
    goal="Use WalletSuite tools inside a CrewAI workflow",
    backstory="Agent with access to WalletSuite MCP tools",
    mcps=[
        MCPServerHTTP(
            url="https://mcp.walletsuite.io",
            headers={"Authorization": f"Bearer {token}"},
            streamable=True,
        )
    ],
)

from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP

server = MCPServerStreamableHTTP(
    url="https://mcp.walletsuite.io",
    headers={"Authorization": f"Bearer {token}"},
)

agent = Agent("your-model", toolsets=[server])

Declare the hosted endpoint as an http MCP server in the run options.

TypeScript
Python

import { query } from "@anthropic-ai/claude-agent-sdk";

const response = query({
  prompt: "What's the ETH price right now?",
  options: {
    mcpServers: {
      walletsuite: {
        type: "http",
        url: "https://mcp.walletsuite.io",
        headers: { Authorization: `Bearer ${token}` }
      }
    }
  }
});

from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    mcp_servers={
        "walletsuite": {
            "type": "http",
            "url": "https://mcp.walletsuite.io",
            "headers": {"Authorization": f"Bearer {token}"},
        }
    }
)

IDE and desktop hosts

IDE and desktop hosts are for prototyping, ad-hoc operator workflows, and demos. For production agent runs, use one of the frameworks above.

Paste a fresh bearer from the connect flow into the host’s config. The bearer is short-lived — re-run the exchange when it expires.

Claude Desktop
Claude Code
Cursor
VS Code

Claude Desktop reads MCP servers from claude_desktop_config.json.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

If the file does not exist yet, create it.

{
  "mcpServers": {
    "walletsuite": {
      "url": "https://mcp.walletsuite.io",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

After saving, fully restart Claude Desktop so it reloads MCP servers.

Add the hosted endpoint as an HTTP server with the bearer header:

claude mcp add --transport http walletsuite https://mcp.walletsuite.io \
  --header "Authorization: Bearer <token>"

Add --scope project (a Claude CLI flag, not a WalletSuite option) to register the server in the project-level .mcp.json so your team shares the same config.Verify with claude mcp list.

Cursor reads MCP servers from mcp.json.

Global: ~/.cursor/mcp.json
Project: .cursor/mcp.json

{
  "mcpServers": {
    "walletsuite": {
      "url": "https://mcp.walletsuite.io",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Reload Cursor so it picks up the new server.

VS Code reads MCP servers from .vscode/mcp.json in the workspace. Use the servers key with type: "http".

{
  "servers": {
    "walletsuite": {
      "type": "http",
      "url": "https://mcp.walletsuite.io",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Start the server from the MCP view, then use it in an Agent-mode chat.

Verify

With the agent connected at the read level, try:

What's the ETH price right now?
Check balances for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
Show me recent transactions for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on ethereum

Authentication is required — the bearer is missing, malformed, or expired. Re-run the connect flow and re-attach a fresh Authorization: Bearer <token>.

Next steps

Connect Your Agent

How the agent authorizes and connects.

Execution Levels

Move an agent from read-only to governed execution.

Trust Model

Non-custodial MPC signing — neither party holds the whole key.

Tool Reference

The full WalletSuite MCP tool surface.

Getting Started

Templates

Reference

Recipes

Install Guides

Agent frameworks

IDE and desktop hosts

Verify

Next steps

Connect Your Agent

Execution Levels

Trust Model

Tool Reference

​Agent frameworks

​IDE and desktop hosts

​Verify

​Next steps

Connect Your Agent

Execution Levels

Trust Model

Tool Reference

Agent frameworks

IDE and desktop hosts

Verify

Next steps