Skip to content
MCP server

gatefareio

MCP server giving AI agents discovery and USDC-paid calls to a marketplace of paid APIs

Runs locally
Install

gatefareio is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, macOS
Runs
Locally
Version
1.1.0
Listing updated

Similar MCP servers

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WALLET_PRIVATE_KEYEVM private key (32 bytes hex). Required for buyer tools (call_api, get_wallet_balance, estimate_cost). Stays on the user's machine.
  • WALLET_BUDGET_USDOptional runtime spend cap in USD; call_api throws BUDGET_EXHAUSTED when reached.
  • WALLET_NETWORKNetwork identifier. Defaults to eip155:8453 (Base mainnet). Use eip155:84532 for Sepolia testnet.
  • GATEFARE_PATPersonal access token (gfpat_...) from gatefare.io/dashboard/tokens. Required for publisher tools (register_api, list_my_apis, update_api, get_revenue, distribute).
  • GATEFARE_BASE_URLOverride the Gatefare base URL (defaults to https://gatefare.io). Useful for self-hosted deployments.

About gatefareio

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.

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free and MIT-licensed; you pay per API call in USDC.

gatefareio 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.

How AIPoweredBot checks servers