SelectaRank Data Gateway MCP

MCP server (stdio) cho cổng dữ liệu SelectaRank x402. Các công cụ được tạo từ OpenAPI của cổng: động đất USGS, thời tiết NOAA/NWS, chỉ số Ngân hàng Thế giới, kiểm tra sơ bộ endpoint x402 và nhiều hơn nữa. Trả phí theo mỗi lần gọi ($0.002-$0.01) bằng USDC trên Base. Nếu không có khóa ví, nó liệt kê các công cụ và trả về các yêu cầu thanh toán mà không cần trả phí.

GitHubDùng thử MCP nàyĐược tài trợ

Tài liệu

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