# sudzikcoin

> sudzikcoin is a paid MCP server for finance and payments. MCP server giving Claude pay-per-call access to US government and freight APIs via x402. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Repository:** https://github.com/sudzikcoin/suverse-mcp
- **MCP Registry name:** io.github.sudzikcoin/mcp-server
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [mcp data access](https://ai-powered.com/categories/mcp-data-access)
- **Listing updated:** 2026-11-21

## About

The README says this server exposes 15 tools to Claude Desktop and other MCP clients, covering SuVerse's pay-per-call US government data services and freight document and routing suite. Paid calls are settled per request in USDC on Base using the x402 protocol, so a funded wallet covers usage without any account or API key.

The wallet private key is read from an environment variable and used only to sign payment authorizations locally. Document tools such as rate confirmations and bills of lading accept local file paths, with restrictions on which folders can be read; the README notes that parsed files are uploaded to SuVerse for processing.

It suits people who already use Claude for logistics paperwork or public-data lookups and want to pay for each call instead of subscribing. Three crypto market verdict tools are also included, which return a payment challenge that the calling agent must settle itself.

## Features

- **Pay-per-call USDC billing:** Each paid tool call settles in USDC on Base via x402, with a per-call ceiling set by an environment variable.
- **Freight document parsing:** Converts rate confirmations, bills of lading, fuel receipts, W-9s, insurance certificates and permits into JSON.
- **US government data queries:** A single gov_query tool reaches 128 government data services, plus CMS Open Payments and FBI crime data tools.
- **Cost estimation and balance checks:** Free tools estimate call prices before running them and report remaining USDC balance and calls available.
- **Local file handling:** Document tools read local files after checking their real file type, limited to the home directory by default.
- **Client-side idempotency:** Identical repeat calls within a short window return a cached response instead of paying again.

## Good for

- Parsing freight paperwork such as rate confirmations and bills of lading inside Claude
- Looking up SEC company information or CMS physician payment records from a chat
- Estimating the cost of a batch of document parses before running them
- Calculating truck-legal routes and toll estimates for a planned trip
- Checking crypto market regime or Solana wallet reputation through an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y @suverselabs/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suverselabs/mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suverselabs/mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@suverselabs/mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suverselabs/mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suverselabs/mcp-server"
      ]
    }
  }
}
```

## Tools

- `freight_parse_ratecon`: Rate confirmation to JSON
- `freight_parse_bol_pod`: Bill of Lading or POD to JSON
- `freight_parse_fuel_receipt`: Fuel receipt to JSON (IFTA)
- `freight_parse_w9`: IRS W-9 to JSON
- `freight_parse_insurance_cert`: ACORD 25 certificate of insurance to JSON
- `freight_parse_permit`: Oversize/overweight permit to JSON
- `freight_truck_route`: Truck-legal routing with tolls and POIs
- `freight_calculate_tolls`: Toll estimate for a polyline
- `freight_trip_telematics`: GPS trip analytics
- `gov_query`: Query any of 128 government services by id
- `gov_cms_open_payments`: CMS Open Payments lookup by NPI
- `gov_fbi_crime_data`: FBI crime statistics by state and year
- `gov_list_services`: List gov_query service ids and parameters
- `suverse_estimate_cost`: Price one or many calls before running them
- `suverse_balance`: On-chain USDC balance and calls remaining
- `suverse_search_endpoints`: Search x402 endpoints known to SuVerse
- `suverse_market_pulse`: Crypto market regime verdict
- `suverse_wallet_reputation`: Solana wallet trading reputation verdict
- `suverse_token_check`: Solana token sanity verdict

## FAQ

### Do I need an API key or account?

The README says there are no accounts or API keys; calls are paid per request in USDC on Base from a funded wallet.

### Do I need ETH for gas?

The README says Base settlements are gas-sponsored, so no ETH is needed.

### Are my documents kept private?

No. The README states that parsed documents are uploaded to api.suverse.io for processing, while the private key stays local.

### What is the maximum charge per call?

By default a call never settles for more than $0.60 USDC, and never more than the tool's published price.

### Is sudzikcoin free?

No. sudzikcoin is a paid product.

### How do I add sudzikcoin to Claude Code?

Run this command in your terminal: claude mcp add mcp-server -- npx -y @suverselabs/mcp-server

### What are the best alternatives to sudzikcoin?

The closest alternatives to sudzikcoin are Webbersites X402 MCP, X402 MCP Server, X402 MCP, web3id paid tools and X402 MCP Tools.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Webbersites X402 MCP](https://ai-powered.com/mcp/webbersites-x402-mcp): Webbersites X402 MCP is an open-source MCP server for finance and payments.
- [X402 MCP Server](https://ai-powered.com/mcp/x402-mcp-server-3): X402 MCP Server is a paid MCP server for agent tooling.
- [X402 MCP](https://ai-powered.com/mcp/x402-mcp-2): X402 MCP is an open-source MCP server for cloud and infrastructure.
- [web3id paid tools](https://ai-powered.com/mcp/web3id-paid-tools): web3id paid tools is a paid MCP server for finance and payments.
- [X402 MCP Tools](https://ai-powered.com/mcp/x402-mcp-tools): X402 MCP Tools is a paid MCP server for mcp data access.
- [X402search MCP](https://ai-powered.com/mcp/x402search-mcp): X402search MCP is a paid MCP server for mcp data access.
- [fetcher.sh — web data for agents](https://ai-powered.com/mcp/fetcher-sh-web-data-for-agents): fetcher.sh — web data for agents is a paid MCP server for web search and scraping.
- [Industrial Platform](https://ai-powered.com/mcp/industrial-platform): Industrial Platform is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/sudzikcoin
