gatefareio
MCP server giving AI agents discovery and USDC-paid calls to a marketplace of paid APIs
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/mcpAdd 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.