XFuel MCP Server
by xfuel-labio.github.XFuel-Lab/xfuel-mcpv0.1.1
Submit AI inference to XFuel, pay per task (USDC via x402 or TFUEL), fetch/verify ZK proofs.
context tax
queued
security
queued
cold start
queued
freshness
Active1d ago
Install XFuel MCP server
Install in Claude Code
claude mcp add xfuel -e XFUEL_API_KEY=xfuel-demo -e XFUEL_MCP_AUTH_TOKEN='<xfuel-mcp-auth-token>' -e XFUEL_PAYER_PRIVATE_KEY='<xfuel-payer-private-key>' -- npx -y xfuel-mcpInstall in Cursor
{
"mcpServers": {
"xfuel": {
"command": "npx",
"args": [
"-y",
"xfuel-mcp"
],
"env": {
"XFUEL_API_KEY": "xfuel-demo",
"XFUEL_MCP_AUTH_TOKEN": "<xfuel-mcp-auth-token>",
"XFUEL_PAYER_PRIVATE_KEY": "<xfuel-payer-private-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"xfuel": {
"command": "npx",
"args": [
"-y",
"xfuel-mcp"
],
"env": {
"XFUEL_API_KEY": "xfuel-demo",
"XFUEL_MCP_AUTH_TOKEN": "<xfuel-mcp-auth-token>",
"XFUEL_PAYER_PRIVATE_KEY": "<xfuel-payer-private-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"xfuel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xfuel-mcp"
],
"env": {
"XFUEL_API_KEY": "xfuel-demo",
"XFUEL_MCP_AUTH_TOKEN": "<xfuel-mcp-auth-token>",
"XFUEL_PAYER_PRIVATE_KEY": "<xfuel-payer-private-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"xfuel": {
"command": "npx",
"args": [
"-y",
"xfuel-mcp"
],
"env": {
"XFUEL_API_KEY": "xfuel-demo",
"XFUEL_MCP_AUTH_TOKEN": "<xfuel-mcp-auth-token>",
"XFUEL_PAYER_PRIVATE_KEY": "<xfuel-payer-private-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| XFUEL_API_URL | — | — | XFuel API base URL. Defaults to the hosted testnet demo. |
| XFUEL_API_KEY | — | yes | API key sent as X-API-Key. Defaults to the shared public demo key. |
| XFUEL_MCP_AUTH_TOKEN | — | yes | Optional bearer token required on the HTTP transport (Authorization: Bearer <token>). |
| XFUEL_RPC_URL | — | — | Theta RPC URL enabling verify_proof's optional on-chain nullifier read. |
| ZK_VERIFIER_ADDRESS | — | — | ZKVerifierSP1 contract address (paired with XFUEL_RPC_URL). |
| XFUEL_PAYER_PRIVATE_KEY | — | yes | Funded payer private key that enables the pay_with_usdc tool. Moves USDC — keep secret; use a low-balance wallet. |
Freshness
Active — last maintenance signal 1d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-09 · 3mo ago · official registry · v0.1.1
FAQ
›How do I install the XFuel MCP server in Claude Code?
Run: claude mcp add xfuel -e XFUEL_API_KEY=xfuel-demo -e XFUEL_MCP_AUTH_TOKEN='<xfuel-mcp-auth-token>' -e XFUEL_PAYER_PRIVATE_KEY='<xfuel-payer-private-key>' -- npx -y xfuel-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does XFuel require an API key?
Yes. It expects XFUEL_API_KEY, XFUEL_MCP_AUTH_TOKEN, XFUEL_PAYER_PRIVATE_KEY, of which 3 are secrets.
›Can I use XFuel as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is XFuel in the official MCP registry?
Yes, as io.github.XFuel-Lab/xfuel-mcp.