@datasig/mcp

MCP server for datasig.ai — supply chain signal intelligence for AI agents.

Gives Claude, GPT-4, and every MCP-compatible agent framework access to real-time trade, logistics, and supplier signals. Each tool call is gated by a x402 USDC micropayment on Base mainnet, handled automatically by the MCP server.

Installation

npm install -g @datasig/mcp

Or run without installing:

npx -y @datasig/mcp

Configuration

The server requires a wallet that holds USDC on Base mainnet (chain ID 8453).

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "datasig": {
      "command": "npx",
      "args": ["-y", "@datasig/mcp"],
      "env": {
        "DATASIG_WALLET_PRIVATE_KEY": "0xYOUR_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root, or to ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "datasig": {
      "command": "npx",
      "args": ["-y", "@datasig/mcp"],
      "env": {
        "DATASIG_WALLET_PRIVATE_KEY": "0xYOUR_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | DATASIG_WALLET_PRIVATE_KEY | Yes | Private key of the USDC payer wallet on Base mainnet | | DATASIG_API_URL | No | Override API base URL (default: https://datasig.ai) |

Tools

Pricing

| Tool | Signal | Min | Max | Tiers | |---|---|---|---|---| | datasig_tariff | Tariff sourcing action | $0.25 | $1.00 | $0.25, $1.00 | | datasig_supplier | Supplier distress action | $0.25 | $0.25 | $0.25 | | datasig_cbp_ruling | CBP customs ruling alert | $1.00 | $1.00 | $1.00 | | datasig_berth_congestion | Port congestion delta | $0.01 | $1.00 | $0.01, $0.10, $1.00 | | datasig_blank_sailing | Blank sailing prediction | $0.10 | $5.00 | $0.10, $1.00, $5.00 |

All payments in USDC on Base mainnet via x402. No subscription. No API key. No account.

datasig_tariff

Get sourcing action intelligence for a product by HTS code and origin country. Returns ACCELERATE_ORDERS, DIVERSIFY_ORIGIN, PAUSE_ORDERS, LOCK_IN_PRICING, or MONITOR_ONLY with full Federal Register and USTR provenance.

Parameters:

• hts_code (required) — HTS code (e.g. 9403.20)
• origin (required) — ISO country code (e.g. CN, MX, VN)

datasig_supplier

Get supplier distress action signals for a sector or named company. Returns QUALIFY_BACKUP_SUPPLIER, INCREASE_SUPPLIER_AUDITS, REDUCE_SUPPLIER_CONCENTRATION, or SUPPLIER_STABLE based on SEC EDGAR filings, BLS layoff data, and news sentiment.

Parameters:

• sector (required) — Industry sector (e.g. furniture, electronics, automotive)
• company (optional) — Specific company name

datasig_cbp_ruling

Get CBP customs ruling alerts for HTS code classification changes. Returns RECALCULATE_LANDED_COST, FLAG_OPEN_POS, or ORIGIN_RULING_STABLE.

Parameters:

• hts_prefix (required) — HTS code without punctuation (e.g. 940320)
• origin (required) — ISO country code (e.g. CN)

datasig_berth_congestion

Get real-time berth congestion delta for major US ports. Returns 24-hour change in vessel wait times, disruption type, and projected recovery time. Alternative port verdicts included at $1.00 tier.

Parameters:

• port (required) — UN/LOCODE: USLAX, USLGB, USOAK, USSEA, USSAV, USNYK
• threshold (optional) — Alert threshold in hours (default: 4.0)

datasig_blank_sailing

Predict carrier blank sailings 5-7 days before official announcement. Returns probability score, probability drivers, projected cancellation date, and alternative carrier options. $5.00 tier when probability exceeds 0.75.

Parameters:

• carrier (optional) — SCAC or carrier name (e.g. MSC, MAEU, CMDU)
• origin (optional) — Origin port UN/LOCODE (e.g. CNSHA)
• destination (optional) — Destination port UN/LOCODE (e.g. USLAX)
• service (optional) — Carrier service name
• voyage (optional) — Voyage number

How x402 payments work

1. Agent calls a tool
2. MCP server hits datasig.ai — receives a 402 Payment Required with payment requirements in the payment-required header
3. Server signs an EIP-3009 TransferWithAuthorization using your wallet key
4. Server retries the request with an X-PAYMENT header
5. datasig.ai verifies and settles the USDC transfer on Base mainnet via Coinbase CDP
6. Signal is returned to the agent

The first 402 shows the base price. If the computed signal falls into a higher tier, a second 402 is returned with the tier price and the server re-signs automatically. The agent never sees a failed call due to tier price adjustment.

Signal accuracy

Track prediction accuracy at datasig.ai/accuracy/ledger. Every signal is logged on-chain with outcome tracking.

License

MIT