MCP.Market

Obol MCP server

by halfkey·io.github.halfkey/obol·v2.0.1
No reviews yet

Solana agent gateway via x402. Wallet, token, DeFi, and swap tools. Pay per request.

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

0 stars37 downloads/wk

Reviews

Write one

Nobody has reviewed Obol yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Obol tools (13, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • obol_defi_positions

    Get DeFi positions for a wallet — LSTs, LP tokens, lending positions, categorized by protocol. Costs $0.10 USDC.

  • obol_health

    Check Obol API health and status. Free.

  • obol_info

    Get Obol API info — all available endpoints, pricing, and payment mode. Free.

  • obol_lst_yields

    Compare LST yields across Solana — jitoSOL, mSOL, bSOL, jupSOL, hSOL, and more. APYs from Sanctum, exchange rates from Jupiter. Costs $0.02 USDC.

  • obol_swap_executewrite action

    Build a Jupiter swap transaction for signing. Returns a serialized transaction the agent must sign and submit. Costs $0.25 USDC.

  • obol_swap_quote

    Get a Jupiter swap quote with route planning and price impact. Costs $0.005 USDC.

  • obol_token_metadata

    Get token metadata — name, symbol, supply, decimals. Costs $0.01 USDC.

  • obol_token_price

    Get real-time token price via Jupiter. Costs $0.005 USDC.

  • obol_wallet_activity

    Get wallet transaction history with categorization (swaps, transfers, etc). Costs $0.05 USDC.

  • obol_wallet_overview

    Get a Solana wallet overview — SOL balance, token count, total value. Costs $0.01 USDC.

  • obol_wallet_pnl

    Wallet P&L analysis — token flows, current values, transaction history analysis. Costs $0.15 USDC.

  • obol_wallet_portfolio

    Get full wallet portfolio — all token holdings with prices, NFTs, and breakdown. Costs $0.05 USDC.

  • obol_wallet_risk

    Multi-factor risk assessment for a Solana wallet — age, diversification, activity patterns. Costs $0.10 USDC.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan29 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 173 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Obol compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 65% of 4,460 AI and agents servers
Tools
13
the typical AI and agents server has 6
Tools that change things
8%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
37
more than 28% of 1,538 AI and agents servers with a package

What its tools let an agent do: 12 read · 1 change

Install Obol in Claude Code, Cursor or VS Code

Runs npx -y obol-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add obol -- npx -y obol-mcp
Add to Cursor

What the publisher says

From the Obol repository's README, as published. We do not edit it. Read it on GitHub

obol

Pay the ferryman. Solana agent gateway via x402.

Obol is a pay-per-use Solana API for AI agents. No API keys, no subscriptions — agents pay per request in USDC using the x402 payment protocol. Solana's sub-cent transaction costs make micropayments viable for the first time.

Named after the coin placed on the tongue of the dead to pay Charon for passage across the River Styx. The original micropayment.

How it works

  1. Agent requests data from a paid endpoint
  2. Obol returns HTTP 402 with a payment requirement (amount, recipient, network)
  3. Agent sends USDC on Solana matching the requirement
  4. Agent retries with transaction proof in the X-PAYMENT header
  5. Obol verifies on-chain and returns the data

No accounts. No tokens. No onboarding. Just pay and go.

Endpoints

Wallet Analytics

Token Data

DeFi

Free

Agent Example

See examples/agent-client.ts for a full reference implementation. The key flow:

import { ObolAgent } from './examples/agent-client';

const agent = new ObolAgent();
await agent.discover();  // fetch pricing
agent.loadWallet(process.env.AGENT_PRIVATE_KEY);

// Auto-discovers price, pays, and returns data
const price = await agent.fetch('/api/v1/token/USDC_MINT/price');

Run in discovery-only mode (no wallet needed):

npx tsx examples/agent-client.ts

MCP Server

Obol ships as an MCP server — any AI agent that supports the Model Context Protocol can discover and call Obol's tools natively.

Install from npm

npm install -g obol-mcp

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "obol": {
      "command": "npx",
      "args": ["-y", "obol-mcp"],
      "env": {
        "OBOL_URL": "https://obol-production.up.railway.app"
      }
    }
  }
}

Or if developing locally:

{
  "mcpServers": {
    "obol": {
      "command": "npx",
      "args": ["tsx", "/path/to/obol/src/mcp.ts"],
      "env": {
        "OBOL_URL": "http://localhost:3000"
      }
    }
  }
}

Available MCP Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Obol: common questions

Is Obol MCP server safe?
Mostly: it is graded B (82/100). Read the Obol safety report
How do I install Obol?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Obol need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is Obol maintained?
The last commit was 210 days ago (2026-04-07). The latest release is v2.0.1.
What can I use instead of Obol?
Servers from other publishers that do the same job: Ausca MCP server, 3D AI Agent Avatar MCP server and Commonly MCP server.
How does Obol compare with other AI and agents MCP servers?
safety score 82/100 (higher than 65% of 4,460 AI and agents servers); tools 13 (the typical AI and agents server has 6); tools that change things 8% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Obol

Same job from other publishers: the closest match first, then the best rated.

  • Ausca
    Pay-per-call APIs and MCP services for agents, no accounts or keys, with verifiable receipts.
    A
  • 3D AI Agent Avatar
    3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.
    B
  • Commonly
    Read Commonly pods and post as a Commonly agent you create, with a token from your Commonly account.
    A
  • mcptoon
    MCP tools + agent skills in one zero-dependency CLI: 71,929 -> 581 tokens (-99.2%, measured).
    A
  • Emilia Protocol
    Exact-action approval for consequential agent actions: request, track, and verify signed receipts.
    B