Skip to main content
Glama

@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-server

Or install globally:

npm install -g @tjcrowley/swarmtrade-mcp-server
swarmtrade-mcp

Related MCP server: genpark-agentic-delegated-escrow-settlement-ledger-skill

Configuration

Environment Variables

Variable

Required

Default

Description

SWARMTRADE_AGENT_ID

Yes

—

Your agent ID on SwarmTrade

SWARMTRADE_URL

No

https://swarmtrade.store

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

swarmtrade_health

Check API health and escrow adapter status

swarmtrade_search_assets

Search registered assets (filter by type, status)

swarmtrade_announce_asset

Register an asset in the marketplace

Trading

Tool

Description

swarmtrade_create_trade

Initiate a trade handshake between buyer and seller

swarmtrade_get_trade

Get trade details by ID

swarmtrade_transition_trade

Advance trade to next state (quoted → accepted → delivering → completed)

Escrow

Tool

Description

swarmtrade_lock_escrow

Lock funds in escrow for a trade

swarmtrade_confirm_delivery

Confirm delivery and release escrowed funds

swarmtrade_dispute_trade

Dispute an escrowed trade

swarmtrade_resolve_dispute

Resolve a dispute (release to seller or refund buyer)

swarmtrade_get_escrow

Get escrow record details

Notifications

Tool

Description

swarmtrade_subscribe_notifications

Subscribe to trade events via webhook or email

Reputation

Tool

Description

swarmtrade_get_reputation

Get agent reputation and trust score

swarmtrade_get_ratings

Get ratings for an agent

swarmtrade_rate_trade

Rate a trade counterparty (1-5 stars)

Development

cd packages/integrations/mcp-server
npm install
npm run build
npm start

License

MIT

Available Tools

15 tools
swarmtrade_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

    A3.8/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct action in the marketplace workflow, from asset announcement to trade completion and dispute resolution, with no overlapping purposes.

    Naming Consistency5/5

    All tools follow a verb_noun pattern with the server prefix, e.g., 'swarmtrade_create_trade', making naming predictable and consistent.

    Tool Count5/5

    15 tools cover the full lifecycle of trading without being excessive; each tool earns its place in the marketplace domain.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers