Skip to main content
Glama
selectarank-mcp

selectarank-mcp

Official
by selectarank

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.

Related MCP server: NEX Agent Co. MCP Server

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

Available Tools

4 tools
selectarank_earthquakesUSGS earthquake feedB

USGS earthquake feed. Paid x402 endpoint: 0.002000 USDC per call on Base (GET /v1/earthquakes/{feed}). With EVM_PRIVATE_KEY set the call is paid automatically; otherwise the 402 payment requirements are returned.

Inputs: feed (required).

selectarank_preflightCheck that an x402 endpoint's 402 challenge is well-formed before paying itA

Check that an x402 endpoint's 402 challenge is well-formed before paying it. Paid x402 endpoint: 0.010000 USDC per call on Base (GET /v1/preflight). With EVM_PRIVATE_KEY set the call is paid automatically; otherwise the 402 payment requirements are returned.

Inputs: url (required).

selectarank_weatherNOAA/NWS forecast for a US pointA

NOAA/NWS forecast for a US point. Paid x402 endpoint: 0.003000 USDC per call on Base (GET /v1/weather/{lat}/{lon}). With EVM_PRIVATE_KEY set the call is paid automatically; otherwise the 402 payment requirements are returned.

Inputs: lat (required), lon (required).

selectarank_worldbankWorld Bank indicatorC

World Bank indicator. Paid x402 endpoint: 0.002000 USDC per call on Base (GET /v1/worldbank/{country}/{indicator}). With EVM_PRIVATE_KEY set the call is paid automatically; otherwise the 402 payment requirements are returned.

Inputs: country (required), indicator (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a clearly distinct resource: preflight validation, earthquakes, weather, and World Bank data. There is no overlap in purpose, so an agent can easily select the right tool.

    Naming Consistency5/5

    All tools follow the same selectarank_ snake_case prefix and use simple noun names (preflight, earthquakes, weather, worldbank). The pattern is predictable and consistent throughout.

    Tool Count5/5

    Four tools is a well-scoped set for a small paid API gateway covering a preflight check plus three specific data sources. Neither too thin nor bloated for the apparent purpose.

    Completeness4/5

    The surface covers a useful validation tool and three concrete data endpoints, but it lacks a tool to list all available endpoints or a generic fetch capability. Minor gaps are workable given the narrow scope.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access 11 paid x402 endpoints as standard MCP tools, paying per call in USDC on Base without API keys, covering chat, code, vision, embeddings, crypto prices, weather, geolocation, forex, and WHOIS data.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Pay-per-call data and tools for AI agents over x402, by UnyKorn. 360 endpoints: DeFi and market data, multi-chain wallet reads, wallet and token risk signals, SEC filings, web and domain intel, and AI text tools. Settled per call in USDC on Base ($0.001-$0.25). No API keys or subscriptions; unpaid calls return the exact quote first.
      21
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access crypto market data such as prices, extreme funding rates, and briefs through MCP tools, with paid calls settled in USDC on Base via x402.
      MIT