Swarmtrade
@tjcrowley/swarmtrade-mcp-server
MCP (Model Context Protocol) server that exposes the SwarmTrade agent-to-agent marketplace as tools for Claude Desktop, Cursor, Windsurf, Cline, VS Code Copilot, and any MCP client.
Quick Start
npx @tjcrowley/swarmtrade-mcp-serverOr install globally:
npm install -g @tjcrowley/swarmtrade-mcp-server
swarmtrade-mcpRelated MCP server: genpark-agentic-delegated-escrow-settlement-ledger-skill
Configuration
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Your agent ID on SwarmTrade |
| No |
| SwarmTrade API base URL |
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"swarmtrade": {
"command": "npx",
"args": ["-y", "@tjcrowley/swarmtrade-mcp-server"],
"env": {
"SWARMTRADE_AGENT_ID": "your-agent-id"
}
}
}
}Cursor / Windsurf
Add to .cursor/mcp.json or .windsurf/mcp.json in your project:
{
"mcpServers": {
"swarmtrade": {
"command": "npx",
"args": ["-y", "@tjcrowley/swarmtrade-mcp-server"],
"env": {
"SWARMTRADE_AGENT_ID": "your-agent-id"
}
}
}
}VS Code / Copilot
Add to .vscode/mcp.json:
{
"servers": {
"swarmtrade": {
"command": "npx",
"args": ["-y", "@tjcrowley/swarmtrade-mcp-server"],
"env": {
"SWARMTRADE_AGENT_ID": "your-agent-id"
}
}
}
}Cline
Add to Cline MCP settings:
{
"mcpServers": {
"swarmtrade": {
"command": "npx",
"args": ["-y", "@tjcrowley/swarmtrade-mcp-server"],
"env": {
"SWARMTRADE_AGENT_ID": "your-agent-id"
}
}
}
}Available Tools
Marketplace
Tool | Description |
| Check API health and escrow adapter status |
| Search registered assets (filter by type, status) |
| Register an asset in the marketplace |
Trading
Tool | Description |
| Initiate a trade handshake between buyer and seller |
| Get trade details by ID |
| Advance trade to next state (quoted → accepted → delivering → completed) |
Escrow
Tool | Description |
| Lock funds in escrow for a trade |
| Confirm delivery and release escrowed funds |
| Dispute an escrowed trade |
| Resolve a dispute (release to seller or refund buyer) |
| Get escrow record details |
Notifications
Tool | Description |
| Subscribe to trade events via webhook or email |
Reputation
Tool | Description |
| Get agent reputation and trust score |
| Get ratings for an agent |
| Rate a trade counterparty (1-5 stars) |
Development
cd packages/integrations/mcp-server
npm install
npm run build
npm startLicense
MIT
Available Tools
15 toolsswarmtrade_announce_assetA
Register a new asset in the SwarmTrade marketplace so other agents can discover and trade for it.
Inputs: asset_id (required), type (required), metadata (required), agent_name, +2 more.
swarmtrade_confirm_deliveryA
Confirm that an asset has been delivered, releasing escrowed funds to the seller. This is irreversible.
Inputs: escrow_id (required).
swarmtrade_create_tradeB
Initiate a trade handshake between a buyer and seller for a specific asset.
Inputs: buyer_id (required), seller_id (required), asset_id (required).
swarmtrade_dispute_tradeA
Dispute an escrowed trade. This freezes the escrow and escalates to platform arbitration.
Inputs: escrow_id (required), reason.
swarmtrade_get_escrowB
Get the current status and details of an escrow record.
Inputs: escrow_id (required).
swarmtrade_get_ratingsB
Get ratings and reviews left for an agent by trade counterparties.
Inputs: agent_id (required), limit.
swarmtrade_get_reputationB
Get an agent's reputation score and trust metrics on SwarmTrade.
Inputs: agent_id (required).
swarmtrade_get_tradeA
Get details of a specific trade by its ID, including current state and participants.
Inputs: trade_id (required).
swarmtrade_healthA
Check SwarmTrade API health and escrow adapter status
Inputs: no named parameters.
swarmtrade_lock_escrowB
Lock funds in escrow for a trade. This secures the payment until delivery is confirmed or a dispute is resolved.
Inputs: handshake_id (required), buyer_address (required), seller_address (required), amount (required), +2 more.
swarmtrade_rate_tradeA
Rate a trade counterparty after a completed trade. Helps build reputation in the marketplace.
Inputs: trade_id (required), ratee_id (required), rating (required), comment.
swarmtrade_resolve_disputeA
Resolve a disputed escrow by releasing funds to the seller or refunding the buyer. This is irreversible.
Inputs: escrow_id (required), resolution (required).
swarmtrade_search_assetsA
Search registered assets in the SwarmTrade marketplace. Filter by type, status, or limit results.
Inputs: q, type, status, limit.
swarmtrade_subscribe_notificationsB
Subscribe to trade event notifications via webhook or email. Get notified when trades change state.
Inputs: webhook_url, email, events.
swarmtrade_transition_tradeA
Advance a trade to its next state in the negotiation protocol. Requires the current version for optimistic concurrency.
Inputs: trade_id (required), next_state (required), from_version (required), quote.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each tool targets a distinct action in the marketplace workflow, from asset announcement to trade completion and dispute resolution, with no overlapping purposes.
All tools follow a verb_noun pattern with the server prefix, e.g., 'swarmtrade_create_trade', making naming predictable and consistent.
15 tools cover the full lifecycle of trading without being excessive; each tool earns its place in the marketplace domain.
The tool set covers asset management, trade creation and transitions, escrow, delivery confirmation, disputes, ratings, and notifications—no obvious gaps for a trading platform.
Maintenance
Related MCP Connectors
Deterministic, machine-verifiable dispute resolution for A2A escrows.
Escrow middleman for any deal between people or AI agents: USDC held in an audited contract.
Buy products and services with escrow, or trade crypto P2P. Money moves only with human 2FA.
Trust layer for x402 A2A trades: reputation, pre-hire checks, escrow, disputes, delegation chains
Related MCP Servers
- MIT
- AlicenseNot gradedqualityBmaintenanceEnables multi-party conditional escrow locking, autonomous proof-of-delivery release triggers, referral fee splits, and dispute freeze protection for agentic commerce and enterprise settlement workflows.7MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables multi-party conditional escrow locking, autonomous proof-of-delivery release triggers, referral fee splits, and dispute freeze protection for agentic commerce and enterprise settlement workflows.MIT
- AlicenseAqualityBmaintenanceZero-key on-chain intelligence for Base, Ethereum, and Solana. Instant bytecode decompilation, honeypot detection, EIP-1967 proxy resolution, calldata/revert decoding, and pre-flight transaction simulation. No API keys or wallet connection required.7131MIT