Skip to main content
Glama
relai-mcp-server

relai-mcp-server

by web3luka

relai-mcp-server

MCP (Model Context Protocol) server for RelAI. Lets any MCP-compatible AI agent authorize itself with RelAI and call paid x402 APIs autonomously.

Tools

Tool

Description

request_authorization

Request a one-time consent link from RelAI to send to the user

poll_authorization

Check if the user approved — returns the service key

call_api

Call any paid API through the RelAI Metered proxy

check_balance

Check the remaining USDC balance in the user's wallet

Related MCP server: x402-mcp

Setup

npm install
npm run build

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "relai": {
      "command": "node",
      "args": ["/path/to/relai-mcp-server/dist/index.js"],
      "env": {
        "RELAI_API_BASE": "https://api.relai.fi"
      }
    }
  }
}

Usage with any MCP client

RELAI_API_BASE=https://api.relai.fi node dist/index.js

Authorization Flow

  1. Agent calls request_authorization → gets a link

  2. Agent shows the link to the user

  3. User opens the link and clicks Allow on relai.fi

  4. Agent calls poll_authorization → gets serviceKey + agentId

  5. Agent calls call_api for any paid API — payments are automatic

Environment Variables

Variable

Default

Description

RELAI_API_BASE

https://api.relai.fi

RelAI API base URL

SATI_PAYER_KEYPAIR

(optional)

Solana keypair (base58 or JSON byte array) — enables SATI on-chain agent identity

SATI Integration (optional)

If SATI_PAYER_KEYPAIR is set, the server automatically:

  1. Registers a SATI identity NFT on Solana when the user approves authorization — giving the agent a verifiable on-chain identity with x402Support: true

  2. Submits positive feedback on-chain after every successful paid API call — building the agent's reputation over time

If SATI_PAYER_KEYPAIR is not set, SATI is silently disabled and everything works normally.

{
  "mcpServers": {
    "relai": {
      "command": "node",
      "args": ["/path/to/relai-mcp-server/dist/index.js"],
      "env": {
        "RELAI_API_BASE": "https://api.relai.fi",
        "SATI_PAYER_KEYPAIR": "<your-solana-wallet-base58>"
      }
    }
  }
}

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Enables MCP clients to access all endpoints of an x402 gateway by paying real-time microtransactions (USDC on Base) per API call, with automatic tool discovery and spend guardrails.
      23
      64 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the x402 protocol that lets AI agents discover and call payment-gated HTTP APIs automatically.
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables users to verify that an AI agent is who it claims to be by combining domain verification, agent-card checks, and a live MCP handshake, with paid requests handled via x402 on Base Sepolia testnet.
      -