# gatefareio

> gatefareio is an open-source MCP server for developer tools. MCP server giving AI agents discovery and USDC-paid calls to a marketplace of paid APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Repository:** https://github.com/gatefareio/mcp-server
- **MCP Registry name:** io.github.gatefareio/mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-21

## About

Gatefare's MCP server lets an AI client search a catalog of paid HTTP APIs, inspect their details, and call them without a per-vendor subscription or API key. Each paid request follows the x402 flow: the server receives a 402 payment challenge, signs a USDC transfer on Base with a wallet key held locally, and retries the call with the payment attached.

The server registers tools based on which environment variables are set. Discovery tools work with no configuration, buyer tools such as call_api, get_wallet_balance and estimate_cost need a wallet private key, and publisher tools for registering and managing your own APIs need a personal access token. An optional budget cap stops spending once a set amount in USD has been reached.

It suits developers who want Claude Desktop, Cursor or a custom agent to pay for data services per call, and API sellers who want to list endpoints on the Gatefare catalog and track revenue.

## Features

- **Catalog search:** Full-text search of paid APIs with filters for price, category and sort order.
- **Pay-per-call requests:** Handles the 402 payment challenge, signs the USDC transfer and retries the request automatically.
- **Local key signing:** Wallet signing happens on the user's machine, so the private key is never sent to Gatefare.
- **Runtime budget cap:** An optional USD limit stops further paid calls once reached.
- **Cost estimation:** Projects the total cost of a planned number of calls before running them.
- **Publisher tools:** Register, update and review your own paid APIs and their revenue when a token is set.
- **Testnet support:** Can be pointed at Base Sepolia for testing instead of mainnet.

## Good for

- Letting an AI assistant fetch live weather or data from pay-per-call APIs
- Finding a paid API for a task by searching the catalog from within an MCP client
- Capping how much an autonomous agent can spend on external API calls
- Publishing your own HTTP endpoint as a paid API and monitoring earnings
- Estimating the cost of a batch of planned API calls before running them

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env GATEFARE_PAT='<GATEFARE_PAT>' -- npx -y @gatefare/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gatefare/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
        "GATEFARE_PAT": "<GATEFARE_PAT>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gatefare/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
        "GATEFARE_PAT": "<GATEFARE_PAT>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gatefare/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
        "GATEFARE_PAT": "<GATEFARE_PAT>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gatefare/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
        "GATEFARE_PAT": "<GATEFARE_PAT>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gatefare/mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
        "GATEFARE_PAT": "<GATEFARE_PAT>"
      }
    }
  }
}
```

## Tools

- `gatefare.search_apis`: Full-text search of the catalog with filters
- `gatefare.get_api`: Full details for one API by slug or handle
- `gatefare.list_categories`: All categories with API counts
- `gatefare.suggest`: Autocomplete suggestions for a query string
- `gatefare.call_api`: Make a paid call, handling 402 signing and retry
- `gatefare.get_wallet_balance`: USDC and ETH balance on Base plus remaining budget
- `gatefare.estimate_cost`: Project total cost for N planned calls
- `gatefare.register_api`: Publish a new paid API
- `gatefare.list_my_apis`: List your published APIs with stats
- `gatefare.update_api`: Edit metadata, price or target URL
- `gatefare.get_revenue`: Revenue time series and totals
- `gatefare.distribute`: Trigger on-chain distribute() payout
- `gatefare.report_abuse`: Report a malicious or stolen API

## FAQ

### Do I need a wallet to use gatefareio?

Only for buyer tools. Discovery tools work without a wallet, while call_api, get_wallet_balance and estimate_cost need WALLET_PRIVATE_KEY.

### Which network do payments use?

By default payments settle as USDC on Base mainnet. Setting WALLET_NETWORK to eip155:84532 switches to the Sepolia testnet.

### Is the server open source?

Yes, it is published under the MIT license on GitHub and npm.

### Where is my private key stored?

It stays in the environment of your own machine and is used only to sign the transfer for each paid call.

### Is gatefareio free?

Yes. gatefareio is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add mcp-server --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env GATEFARE_PAT='<GATEFARE_PAT>' -- npx -y @gatefare/mcp

### What are the best alternatives to gatefareio?

The closest alternatives to gatefareio are Xenarch MCP, PayGate MCP — Monetization Gateway for AI Agents, WarpPay402 MCP Gateway, X402 Api and X402 Bazaar MCP.

## 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

- [Xenarch MCP](https://ai-powered.com/mcp/xenarch-mcp): Xenarch MCP is an open-source MCP server for crypto and web3.
- [PayGate MCP — Monetization Gateway for AI Agents](https://ai-powered.com/mcp/paygate-mcp-monetization-gateway-for-ai-agents): PayGate MCP — Monetization Gateway for AI Agents is an open-source MCP server for agent payments.
- [WarpPay402 MCP Gateway](https://ai-powered.com/mcp/warppay402-mcp-gateway): WarpPay402 MCP Gateway is a paid MCP server for web search and scraping.
- [X402 Api](https://ai-powered.com/mcp/x402-api): X402 Api is a paid MCP server for crypto and web3.
- [X402 Bazaar MCP](https://ai-powered.com/mcp/x402-bazaar-mcp): X402 Bazaar MCP is a freemium MCP server for crypto and web3.
- [Amanchain MCP](https://ai-powered.com/mcp/amanchain-mcp): Amanchain MCP is a paid MCP server for ai models and llm tooling.
- [X402 MCP Server](https://ai-powered.com/mcp/x402-mcp-server-3): X402 MCP Server is a paid MCP server for agent tooling.
- [Spraay X402 MCP](https://ai-powered.com/mcp/spraay-x402-mcp): Spraay X402 MCP is a freemium MCP server for finance and payments.

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