Skip to main content

​
What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI applications to connect to external tools and data sources. OneShot provides an MCP server that exposes all our tools to any MCP-compatible client.

​
Supported Clients

Claude Desktop

Anthropic’s desktop application for Claude

Cursor

AI-first code editor

Claude Code

Anthropic’s CLI for Claude

Any MCP Client

Works with any MCP-compatible application

​
Installation

npm install -g @oneshot-agent/mcp-server
Or use directly with npx (recommended for MCP configs): 
npx -y @oneshot-agent/mcp-server

​
Configuration

​
Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows): 
{
  "mcpServers": {
    "oneshot": {
      "command": "npx",
      "args": ["-y", "@oneshot-agent/mcp-server"],
      "env": {
        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
      }
    }
  }
}

​
Cursor

Add to .cursor/mcp.json in your project: 
{
  "mcpServers": {
    "oneshot": {
      "command": "npx",
      "args": ["-y", "@oneshot-agent/mcp-server"],
      "env": {
        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
      }
    }
  }
}

​
Claude Code

Add to ~/.claude/settings.json: 
{
  "mcpServers": {
    "oneshot": {
      "command": "npx",
      "args": ["-y", "@oneshot-agent/mcp-server"],
      "env": {
        "ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
      }
    }
  }
}

​
Environment Variables

VariableRequiredDescription
ONESHOT_WALLET_PRIVATE_KEYYesYour agent’s private key for signing payments
ONESHOT_TEST_MODENoSet to "false" for production (default: "true" uses testnet)
Never commit your private key to version control. Use environment variables or a secrets manager.

​
Available Tools

Once configured, your AI client will have access to all OneShot tools:

​
Communication

ToolDescriptionCost
oneshot_emailSend emails with attachments~$0.01
oneshot_voiceMake phone calls~$0.25/min
oneshot_smsSend SMS messages~$0.035/segment

​
Inbox

ToolDescriptionCost
oneshot_inbox_listList received emailsFree
oneshot_inbox_getGet a specific emailFree
oneshot_sms_inbox_listList received SMS messagesFree
oneshot_sms_inbox_getGet a specific SMS messageFree

​
Research & Enrichment

ToolDescriptionCost
oneshot_researchDeep web research with sources0.50−0.50-2.00
oneshot_people_searchSearch for people by title, company, etc.~$0.10/result
oneshot_enrich_profileEnrich person profile from LinkedIn/email~$0.10
oneshot_find_emailFind someone’s email address~$0.10
oneshot_verify_emailVerify email deliverability~$0.01

​
Commerce

ToolDescriptionCost
oneshot_commerce_searchSearch for productsFree
oneshot_commerce_buyPurchase productsProduct price + fee

​
Build

ToolDescriptionCost
oneshot_buildBuild and deploy production websites~$10+
oneshot_update_buildUpdate an existing websiteDiscounted

​
Account

ToolDescriptionCost
oneshot_notificationsList agent notificationsFree
oneshot_mark_notification_readMark notification as readFree
oneshot_get_balanceGet USDC wallet balanceFree

​
Usage Examples

Once configured, simply ask your AI client to perform actions:
“Send an email to [email protected] with subject ‘Meeting Tomorrow’ and let him know we need to reschedule to 3pm”
“Call the restaurant at +14155551234 and make a reservation for 4 people at 7pm tonight”
“Research the latest developments in quantum computing and give me a summary with sources”
“Build a landing page for my new SaaS product called TaskFlow - it’s an AI-powered task management tool for remote teams”
“What’s my OneShot wallet balance?”

​
Funding Your Agent

Fund your agent wallet at oneshotagent.com with USDC on Base network.
EnvironmentNetworkPricing
Test Mode (default)Base Sepolia testnetFree - get test USDC from faucets
Production ModeBase MainnetFull pricing - requires real USDC
The MCP server runs in test mode by default, so you can experiment without spending real USDC.

​
Troubleshooting

  1. Verify the config file path is correct for your OS
  2. Restart your AI client after saving the config
  3. Check that npx is available in your PATH
Ensure ONESHOT_WALLET_PRIVATE_KEY is set in the env section of your config.
  1. Check your balance with oneshot_get_balance
  2. Fund your wallet at oneshotagent.com
  3. For testing, ensure ONESHOT_TEST_MODE is not set to "false"

npm Package

View on npm registry

SDK Documentation

Full SDK documentation

Pricing

Detailed pricing information

MCP Protocol

Learn about MCP