mcpField
G
globalrules

globalrules

Local
github.com/yk647Legal & Government0Updated 8w ago
Repository

About globalrules

globalrules-mcp serves verified facts about countries, covering topics such as taxes, holidays, tipping, visas, and minimum wages. Agents can query and compare this data, with per-call USDC payments handled through x402.

Key features

  1. 01List covered countries
  2. 02Retrieve multiple facts for one country
  3. 03Query one country fact
  4. 04Compare one fact across countries
  5. 05Fetch the sourced full dataset
  6. 06Automatic x402 payments

Use cases

  1. 01Check holiday or visa details for a destination
  2. 02Compare taxes or minimum wages across countries
  3. 03Verify country facts for cross-border research

MCP support

The MCP server exposes tools to query and compare country facts and retrieve the full dataset. Calls use automatic per-call USDC payments via x402 on Base.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "yk647-globalrules": {
      "command": "npx",
      "args": [
        "-y",
        "globalrules-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "GLOBALRULES_API": "<GLOBALRULES_API>"
      }
    }
  }
}
Run commandnpx -y globalrules-mcp
Environment variables to set
EVM_PRIVATE_KEYSecretOptional. Your EVM wallet private key (0x + 64 hex), used to sign x402 USDC payments on Base mainnet for paid tools. Free tools (list_countries, get_country_overview) work without this. Use a dedicated low-balance wallet funded with a few USDC.
GLOBALRULES_APIOptional override of the GlobalRules API base URL. Default: https://globalrules-api.onrender.com

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmglobalrules-mcp1.1.2

Tools

7

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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

ToolWhat it doesPrice/call
list_countriesAll 70 covered countries$0.005
get_country_factsAll ~51 facts for one country$0.03
get_country_factOne fact for one country$0.01
compare_countriesOne fact across all 70 countries$0.02
get_full_datasetComplete 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.

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.