@ifalabs/mcp-server

Live stablecoin price feeds for AI tools — powered by the IFÁ Labs decentralized oracle.

Ask Claude, Cursor, Windsurf, or any MCP-compatible AI client for live on-chain stablecoin prices, asset IDs, feed freshness, and network configuration — without leaving your editor.

> "What is the current CNGN/USD price from IFÁ Labs?"

IFÁ Labs MCP → get_asset_price → Base Mainnet

CNGN/USD: $0.000613
Last updated: 412 seconds ago ✓ Fresh

Installation

npm install -g @ifalabs/mcp-server

Verify the installation:

ifa-mcp --version
# @ifalabs/mcp-server v1.1.0

Quick Start

Claude Desktop

Open or create the config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ifalabs": {
      "command": "ifa-mcp",
      "args": ["--network", "base-mainnet"]
    }
  }
}

Restart Claude Desktop and ask:

"What is the current USDT/USD price from IFÁ Labs?"

Cursor / Windsurf / TRAE

Go to Settings → MCP Servers → Add New and paste:

{
  "mcpServers": {
    "ifalabs": {
      "command": "ifa-mcp",
      "args": ["--network", "base-mainnet"]
    }
  }
}

Windows users: Cursor cannot resolve the ifa-mcp binary directly because npm wraps global binaries in a .cmd file that Cursor does not execute. Use one of these formats instead:

Option A — node with local path:

{
  "mcpServers": {
    "ifalabs": {
      "command": "node",
      "args": ["C:/Users/YOUR_USERNAME/path/to/ifamcpserver/dist/index.js", "--network", "base-mainnet"]
    }
  }
}

Option B — npx:

{
  "mcpServers": {
    "ifalabs": {
      "command": "npx",
      "args": ["-y", "@ifalabs/mcp-server", "--network", "base-mainnet"]
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | get_asset_price | Fetch the current on-chain price for a single asset | | get_multiple_prices | Fetch prices for multiple assets in one RPC call | | get_derived_pair | Compute a cross-asset price — e.g. CNGN in USDT terms | | get_supported_assets | List all supported assets, IDs, and metadata | | get_asset_id | Resolve a symbol string to its 32-byte asset ID | | check_price_freshness | Check feed age against a configurable staleness threshold | | get_network_info | Get contract addresses, object IDs, and RPC URLs for all networks |

Supported Assets

All feeds are USD-denominated and available across every supported network.

| Symbol | Name | Category | Asset ID | |--------|------|----------|----------| | USDT/USD | Tether | Global | 0x6ca0cef6107263f3b09a51448617b659278cff744f0e702c24a2f88c91e65a0d | | USDC/USD | USD Coin | Global | 0xf989296bde68043d307a2bc0e59de3445defc5f292eb390b80d78162c8a6b13d | | CNGN/USD | Nigerian Naira Stablecoin | Emerging Market | 0x83a18c73cf75a028a24b79cbedb3b8d8ba363b748a3210ddbcaa95eec3b87b3a | | ZARP/USD | South African Rand Stablecoin | Emerging Market | 0x12373a3b1c4827c84bf6d7b11df100442695d0abfdb7a20d30a41d67d58e75a8 | | BRZ/USD | Brazilian Real Stablecoin | Emerging Market | 0xbc60b55b031dce1ee5679098bf2f35d66a94a566124e2b233324d2bafcc6d5b5 | | ETH/USD | Ethereum | Reference | 0x8c3fb07cab369fe230ca4e45d095f796c4c1a30131f1799766d4fec5ee1325c0 |

Full asset reference: docs.ifalabs.com/supported-assets

Supported Networks

EVM Networks

| Network | Chain ID | Oracle Address | Status | |---------|----------|----------------|--------| | base-mainnet (default) | 8453 | 0xA9F17344689C2c2328F94464998db1d3e35B80dC | 🟢 Live | | base-sepolia | 84532 | 0xbF2ae81D8Adf3AA22401C4cC4f0116E936e1025b | 🔵 Testnet | | assetchain-testnet | 42421 | 0xBAc31e568883774A632275F9c8E7A5Bd117000F7 | 🔵 Testnet |

Sui

| Network | Package ID | Feed Object ID | Status | |---------|------------|----------------|--------| | sui-testnet | 0x4d165602d4bb3a7d428a3aa567e27cbe03c9de2ed5995f8c13d1adc4cd3d196f | 0x9d5fc0fce3dc11efd95ef4b3218f3b45ff17012fbc629b35529f66833e46d91a | 🔵 Testnet |

Note: Price read tools (get_asset_price, get_multiple_prices, etc.) only support EVM networks. Use get_network_info with network: "sui-testnet" to retrieve Sui object IDs for use with the Sui TypeScript SDK or Move contracts.

Example Prompts

• "What is the current CNGN/USD price on Base Mainnet?"
• "Get prices for USDT, CNGN, ZARP, and BRZ from IFÁ Labs."
• "Is the CNGN/USD feed fresh within a 2-hour window?"
• "What is the IFÁ Labs asset ID for ZARP/USD?"
• "How much USDT is one CNGN worth right now?"
• "Give me a full network reference for all IFÁ Labs deployments."
• "What are the Sui Testnet object IDs for IFÁ Labs?"
• "Run a health check on all IFÁ Labs price feeds."

Supported MCP Clients

| Client | Type | Status | |--------|------|--------| | Claude Desktop | AI Assistant | ✅ Full support | | Cursor | AI Code Editor | ✅ Full support | | Windsurf | AI Code Editor | ✅ Full support | | TRAE | AI Code Editor | ✅ Full support | | Zed | AI Code Editor | ✅ Full support | | Continue | VS Code / JetBrains | ✅ Full support | | LangChain / CrewAI / AutoGen | Agent Frameworks | ✅ Programmatic |

Full client setup guide: docs.ifalabs.com/installation-and-setup

CLI Options

--network <name>         Target network (default: base-mainnet)
                         Options: base-mainnet, base-sepolia,
                                  assetchain-testnet, sui-testnet
--rpc-url <url>          Override the default RPC URL
--max-price-age <secs>   Default staleness threshold in seconds (default: 3600)
--transport <type>       Transport mode: stdio or sse (default: stdio)
--port <number>          Port for SSE transport (default: 3000)
--log-level <level>      Logging verbosity: silent | error | info | debug (default: error)
--version                Print version and exit
--help                   Print usage and exit

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests
npm test

# Run locally with debug logging
node dist/index.js --network base-mainnet --log-level info

# Inspect all tools via MCP Inspector
npx @modelcontextprotocol/inspector dist/index.js

Changelog

v1.1.0

• get_network_info now includes Sui Testnet — returns package_id, feed_id, verifier_id, explorer links, and a note on which ID to use when reading prices
• networkType field ("evm" | "sui") added to all network config entries
• EVM-only tools return a structured error when sui-testnet is passed, directing developers to use get_network_info for Sui object IDs instead

v1.0.0

• Initial release
• 7 MCP tools exposing the full IFÁ Labs oracle infrastructure
• Supported networks: Base Mainnet, Base Sepolia, AssetChain Testnet
• Supported assets: USDT/USD, USDC/USD, CNGN/USD, ZARP/USD, BRZ/USD, ETH/USD
• Supported clients: Claude Desktop, Cursor, Windsurf, TRAE, Zed, Continue, LangChain, CrewAI, AutoGen

Links

| | | |-|-| | Documentation | docs.ifalabs.com | | MCP Server Guide | docs.ifalabs.com/what-is-the-ifa-labs-mcp-server | | Website | ifalabs.com | | npm | @ifalabs/mcp-server | | Telegram | t.me/ifalabs | | X / Twitter | @ifalabs | | GitHub | IFA-Labs |

License

MIT © IFÁ Labs