Solana Alpha x402

io.github.nero-zngPublished by GitHub account nero-zngv1.4.0Updated Nov 5, 2026

Pay-per-call Solana market intel via x402 USDC: price, news, trending, perps, rugcheck, wallet.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local stdio MCP server that gives an assistant pay-per-call Solana market data — price, news, trending, perps, rugcheck, wallet and token reports — paid in…

What you can do
  • List the pricing of each paid endpoint for free
  • Fetch token price, news and newly listed tokens
  • Fetch trending tokens and perpetuals data
  • Run rugcheck and wallet lookups
  • Generate a full token report
  • Return readable 402 payment requirements when no key is configured
When to use it
Useful when an assistant needs live Solana market intelligence — token prices, news, trending lists, perp data, rug or wallet checks — and you are willing to pay small per-call USDC fees, or only want to discover the payment terms first.
Requirements
Runs as a local Node.js process (stdio), started via node or npx, or from the published container image. Network access to the Solana Alpha API over HTTPS. Optional environment variables: SOLANA_PRIVATE_KEY (base58 or JSON byte array) to auto-pay, MAX_PRICE_USDC to cap spend per call, and API_BASE_URL or SOLANA_ALPHA_API_BASE to override the endpoint. A funded Solana wallet with USDC is needed for paid calls.
Before you install
Paid calls spend real USDC from the wallet behind SOLANA_PRIVATE_KEY; use a funded burner wallet only and set MAX_PRICE_USDC as a cap. Never commit, screenshot or paste the private key anywhere. Requests go to a third-party API host, and the payment recipient address is hard-coded in the server.

Installation

In SourceWeft

  1. Open Solana Alpha x402 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

solana-alpha-x402-mcp

[MCP score]

stdio MCP server for the Solana Alpha API (x402 v2, USDC on Solana mainnet).

One tool per paid HTTP endpoint, plus a free list_pricing tool. Each tool calls the live API at https://solana-x402-data.netlify.app (override with API_BASE_URL).

ToolEndpointPrice
list_pricing—free
get_price/api/price0.005 USDC
get_news/api/news0.005 USDC
get_new/api/new0.005 USDC
get_trending/api/trending0.01 USDC
get_perps/api/perps0.01 USDC
get_rugcheck/api/rugcheck0.01 USDC
get_wallet/api/wallet0.02 USDC
get_token_report/api/token-report0.08 USDC

PayTo (never change): 3WN7T7VMnRJzjRhKosbaT2oiwuMiBCe6KBfZGiZygv7n

Behavior

  • No SOLANA_PRIVATE_KEY: tools still call the live API. A 402 is returned as a readable JSON result (price, payTo, network, asset, feePayer) — not a hard failure — so agents can discover payment requirements.
  • With SOLANA_PRIVATE_KEY: uses @x402/fetch + @x402/svm (ExactSvmScheme) to sign and settle USDC payments automatically. Optional MAX_PRICE_USDC rejects calls above the cap.
  • This package is a standalone Node MCP server; it talks to the live Solana Alpha API over HTTPS and does not embed Netlify Functions.

Install (local / from this repo)

bash
npm installnpm run smoke          # initialize + tools/list + get_price → 402 info (no key, no payment)

Published npm name (when published): solana-alpha-x402-mcp
Until then, point your MCP host at the local entry: node /absolute/path/to/solana-alpha-x402-mcp/src/index.mjs

Environment

VariableRequiredMeaning
SOLANA_PRIVATE_KEYnoBuyer secret key: base58 (Phantom/Solana CLI export) or JSON byte array […]. Never commit this.
MAX_PRICE_USDCnoCap per call (e.g. 0.02). Listed price above the cap → error, no payment.
API_BASE_URLnoDefault https://solana-x402-data.netlify.app

Claude Desktop (claude_desktop_config.json)

json
{  "mcpServers": {    "solana-alpha-x402": {      "command": "node",      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],      "env": {        "API_BASE_URL": "https://solana-x402-data.netlify.app"      }    }  }}

With auto-pay (use a funded burner wallet only):

json
{  "mcpServers": {    "solana-alpha-x402": {      "command": "node",      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],      "env": {        "SOLANA_PRIVATE_KEY": "YOUR_BASE58_SECRET",        "MAX_PRICE_USDC": "0.08",        "API_BASE_URL": "https://solana-x402-data.netlify.app"      }    }  }}

After npm publish of this package you can use:

json
{  "mcpServers": {    "solana-alpha-x402": {      "command": "npx",      "args": ["-y", "solana-alpha-x402-mcp"],      "env": {        "MAX_PRICE_USDC": "0.08"      }    }  }}

Cursor (mcp.json)

Project or user MCP config:

json
{  "mcpServers": {    "solana-alpha-x402": {      "command": "node",      "args": ["/ABSOLUTE/PATH/TO/solana-alpha-x402-mcp/src/index.mjs"],      "env": {        "API_BASE_URL": "https://solana-x402-data.netlify.app"      }    }  }}

Or via npx once published:

json
{  "mcpServers": {    "solana-alpha-x402": {      "command": "npx",      "args": ["-y", "solana-alpha-x402-mcp"]    }  }}

Discovery (HTTP, free)

Public discovery documents on the live API host:

Safety

  • Do not put a real funded key in git, screenshots, or chat logs.
  • Smoke tests intentionally unset SOLANA_PRIVATE_KEY and never settle a payment.
  • PayTo is a receive-only public address hard-coded to match the API; changing it would break settlement against the live service.

Source: README.md at commit 3614eb1

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

1
  1. v1.4.0LatestNov 5, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts