Mcp Gauge
by CHANGCHINFUcommunityv1.0.0
An MCP server that exposes GAUGE verifiable, official-source signals across domains like weather, drought, agriculture, power grid, shipping, and regulatory filings. It supports both free tools and paid per-call tools, with paid calls settled in USDC via x402 using a configured Base wallet key.
From the registry: US government data (USGS/NOAA/SEC/FDA) with cryptographic proof; x402 pay-per-call, no API key
Install & configure
Prerequisites
- requiredInstall Node.js 18+Node.js version 18 or newer is required to run the MCP server via npx.
- optionalProvide a Base wallet private key with a small USDC balance for paid toolsRequired only if you want to use paid gauge_* tools. Free tools work without a wallet key. The key should be for a Base-mainnet wallet funded with a small amount of USDC; no ETH is needed because payments are gasless via EIP-3009.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-gauge` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 18+** — Node.js version 18 or newer is required to run the MCP server via npx.
Optional prerequisites:
- Provide a Base wallet private key with a small USDC balance for paid tools — Required only if you want to use paid gauge_* tools. Free tools work without a wallet key. The key should be for a Base-mainnet wallet funded with a small amount of USDC; no ETH is needed because payments are gasless via EIP-3009.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","github:CHANGCHINFU/mcp-gauge"]
- optional environment variables:
- `EVM_PRIVATE_KEY`: Base-mainnet wallet private key used to pay for paid tools. Omit to use free tools only. (example: `<your-base-wallet-private-key>`)
- `GAUGE_BASE_URL`: Override the GAUGE service base URL. (example: `<your-gauge-base-url>`)
- `GAUGE_MAX_USDC`: Atomic per-call payment cap in USDC base units. (example: `<your-max-usdc-cap>`)
Note: Preferred install path is GitHub via npx. This is the stdio server. The README also mentions a separate hosted remote Smithery server, but it is a different server with different tools and payment behavior, so it is not the canonical config for this package.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Preferred install path is GitHub via npx. This is the stdio server. The README also mentions a separate hosted remote Smithery server, but it is a different server with different tools and payment behavior, so it is not the canonical config for this package.
Tools (10)
gauge_catalog
Lists all signals and queryable entities
gauge_preview
Shows coverage, pricing menu, and bundle lists
gauge_sample
Returns a full sample record
gauge_river_free
Returns a raw US river reading by USGS site id
gauge_flood_risk
Returns a flood-risk/anomaly record versus official thresholds plus seasonal anomaly and hash
gauge_region
Returns a city bundle with air, precipitation, river, and cross-check data
gauge_crop_drought
Returns agriculture signals combining drought, heat/GDD, and crop VHI
gauge_grid_stress
Returns power grid signals combining demand, renewables, and energy inflation
gauge_route_disruption
Returns shipping signals combining route disruption, sea state, and AIS throughput
gauge_filing_check
Returns regulatory filing signals combining 8-K, late filing, and Form 4 insider data
Environment variables
EVM_PRIVATE_KEYrequiredBase wallet private key used to pay for paid toolsGAUGE_BASE_URLBase URL for the GAUGE serviceGAUGE_MAX_USDCMaximum per-call USDC amount capPrerequisites
- • Node 18+
Remote Endpoints
https://aeml-x402.zeabur.app/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- MIT
- Released
- Jul 30, 2026
- Last commit
- Jul 31, 2026
- Registry name
- io.github.CHANGCHINFU/mcp-gauge