SelectaRank Data Gateway MCP

SelectaRank x402データゲートウェイ用のMCPサーバー（stdio）。ツールはゲートウェイのOpenAPIから生成される：USGS地震、NOAA/NWS天気、世界銀行指標、x402エンドポイントのプレフライトチェックなど。Base上のUSDCで呼び出しごとに支払い（$0.002〜$0.01）。ウォレットキーがない場合、ツールを一覧表示し、支払い要件を支払いなしで返す。

GitHubこのMCPを試すスポンサー

ドキュメント

selectarank-mcp

MCP server (stdio) for the SelectaRank Data Gateway, a pay-per-call API that uses the x402 protocol with USDC on Base. It lets an AI agent discover the gateway's paid endpoints as MCP tools and, if you give it a wallet key, pay for them automatically.

MCP Registry name: io.github.selectarank/selectarank-mcp

Tools

Tools are generated from the gateway's /openapi.json at startup (a built-in copy of the list is used if it cannot be fetched).

Tool	Endpoint	Price per call (USDC)	Data source
`selectarank_earthquakes`	`GET /v1/earthquakes/{feed}`	0.002	USGS
`selectarank_weather`	`GET /v1/weather/{lat}/{lon}` (US only)	0.003	NOAA/NWS
`selectarank_worldbank`	`GET /v1/worldbank/{country}/{indicator}`	0.002	World Bank
`selectarank_jgbYields`	`GET /v1/jp/jgb-yields?days=`	0.002	Japan government bond yield curve 1Y-40Y (Ministry of Finance, PDL 1.0)
`selectarank_ustYields`	`GET /v1/us/treasury-yields?days=`	0.002	US Treasury par yield curve (US Treasury)
`selectarank_ecbFx`	`GET /v1/eu/ecb-fx?currencies=&days=`	0.002	ECB euro reference FX rates
`selectarank_secFilings`	`GET /v1/us/sec/filings/{cik}`	0.003	Recent SEC EDGAR filings by CIK, with document URLs
`selectarank_preflight`	`GET /v1/preflight?url=`	0.010	Checks another x402 endpoint's 402 challenge (one unauthenticated GET, no funds move)

The data tools (earthquakes, weather, World Bank, JGB/US yields, ECB FX, SEC filings) return public-domain upstream data wrapped with source and license metadata. The gateway is a passthrough; it does not produce its own data.

Payment

Network: Base mainnet (eip155:8453), scheme exact
Asset: USDC, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Recipient (payTo): 0x57a0c0b413516BbF3Fcdb88408D59B7809e3efd0

Always verify these against the live 402 response; the server returns the gateway's actual PaymentRequirements.

Install

Requires Node.js 18+.

{
  "mcpServers": {
    "selectarank": {
      "command": "npx",
      "args": ["-y", "github:selectarank/selectarank-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

Omit env to run without paying (see below). Installed straight from GitHub for now; it is not yet published to npm.

Environment variables

Variable	Required	Meaning
`EVM_PRIVATE_KEY`	no	Private key of a wallet holding USDC on Base. With it, tool calls pay automatically via `@x402/fetch`. Use a dedicated low-balance wallet. Never committed or logged by this package.
`SELECTARANK_MAX_PRICE_USDC`	no	Refuse to auto-pay above this amount per call. Default `0.05`.
`SELECTARANK_BASE_URL`	no	Override the gateway URL. Default `https://selectarank-data.vercel.app`.

Behavior without a key

Without EVM_PRIVATE_KEY the server still starts and lists all tools. Calling a tool makes one unpaid request and returns the 402 PaymentRequirements (amount, asset, payTo, network) plus instructions for paying. Nothing is spent.

Status and limits

Sales to date: 0. This is a new service.
The data comes from USGS, NOAA/NWS and the World Bank; freshness and accuracy are theirs. No SLA.
You are responsible for the funds in the wallet you configure.

Development

npm install
npm run build
npm run typecheck

License

MIT