Skip to main content
Glama
globalrules-mcp

globalrules-mcp

by yk647

globalrules-mcp

Communication language (internal note for AI agents working in this repo, e.g. Claude): always communicate with the user in Japanese (常に日本語でコミュニケーションすること). This note does not apply to the public package documentation below, which remains in English for npm/MCP users.

MCP server for GlobalRules — verified country facts (VAT/GST, government-verified 2026–2027 public holidays, tipping, visas, minimum wages… 51 topics × 70 countries) with automatic x402 micropayments (USDC on Base). No signup, no API key: bring your own wallet key and pay $0.005–$0.25 per call.

Tools

Tool

What it does

Price/call

list_countries

All 70 covered countries

$0.005

get_country_facts

All ~51 facts for one country

$0.03

get_country_fact

One fact for one country

$0.01

compare_countries

One fact across all 70 countries

$0.02

get_full_dataset

Complete dataset with sources

$0.25

Using LangChain, CrewAI, or another agent framework instead of Claude Desktop? See AGENT_FRAMEWORKS.md for drop-in code — no marketplace discovery required, your agent calls this tool directly.

Related MCP server: santyvv-data-mcp

Setup (Claude Desktop)

{
  "mcpServers": {
    "globalrules": {
      "command": "npx",
      "args": ["-y", "globalrules-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x<your wallet private key>" }
    }
  }
}

(From source instead: "command": "node", "args": ["<path-to>/GlobalRules/mcp/index.mjs"])

  • EVM_PRIVATE_KEY is your wallet's private key, used only to sign x402 payments (USDC on Base mainnet). Fund it with a few USDC. Use a dedicated low-balance wallet; never your main wallet.

  • Payments are handled automatically per call via the x402 protocol (HTTP 402 → sign → retry). No account is created anywhere.

Try it in 2 minutes with a throwaway $5 wallet

You don't need to touch your main wallet. Fastest path to a first call:

  1. Generate a fresh burner key: node -e "console.log(require('viem/accounts').generatePrivateKey())" (or any wallet app's "create new wallet" flow)

  2. Send ~$5 of USDC on Base to that wallet's address (bridge from any chain via bridge.base.org, or buy directly on Coinbase and withdraw to Base)

  3. Drop the private key into EVM_PRIVATE_KEY above and run a call — at $0.005–$0.02/call, $5 covers hundreds of requests

  4. Throw the key away when done; it never touches anything but this one low-balance wallet

No signup form, no dashboard, no recurring charge — just pay-per-call.

How it works

Built on the official CDP pattern (MCP Server with x402): @x402/axios wraps HTTP calls, detects 402 Payment Required, signs a USDC payment with your key, and retries — transparent to the agent.

Data source & terms: https://globalrules.org/llms.txt · Payment metadata: https://globalrules.org/.well-known/x402

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      F
      maintenance
      Enables AI agents to call offline French legal helpers via a paid x402 API, covering e-invoice reform dates, L441-10 penalties, VAT, SIRET/IBAN checks, and dozens of invoice mention generation tools for $0.01 USDC on Base per call.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to fetch crypto market and on-chain data, including prices across venues, token facts, OHLC candles, market overview, DeFi TVL, and wallet balances, with two free tools and the rest paid per call in USDC on Base via x402.
      8
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to look up a sourced, versioned dataset covering every country in Arabic, English, or both: names, nationalities, capitals, currencies, languages, time zones, dial codes, phone validation, address formats, and ISO 3166-2 subdivisions. Supports country search with Arabic-aware normalization, phone parsing to E.164, nationality selection, and subdivision lookups.
      786 npm
      -