Globalrules MCP server
io.github.yk647/globalrules·v1.1.2Verified country facts (VAT, holidays, visas; 114 countries). Free + paid (x402 USDC) tools.
0 stars95 downloads/wk
Reviews
Write oneNobody has reviewed Globalrules yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Globalrules tools (7)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
compare_countriesOne fact across ALL covered countries in a single call (e.g. VAT rates worldwide, minimum wages worldwide). The bulk alternative to 120+ single calls. $0.02 per call via x402.
get_country_factOne specific fact for one country as structured JSON with source URL (e.g. vat, holidays_2026_sample, tipping, minimum_wage, digital_nomad_visa). Cheapest single lookup. $0.01 per call via x402.
get_country_factsAll ~55 verified facts for one country as structured JSON with source URLs and verification dates: VAT/GST, government-verified 2026-2027 public holidays, tipping, plugs, visas, minimum wage, business etiquette and more. $0.03 per call via x402 (USDC on Base, automatic).
get_country_overviewFREE. Human-readable overview page for one country (same content as globalrules.org): key facts summary in Markdown. For structured JSON with source URLs and verification dates, use the paid get_country_facts tool.
get_full_datasetThe complete GlobalRules dataset: 120+ countries x ~55 verified topics with sources and verification dates. For caching/analysis. $0.25 per call via x402.
list_countriesFREE. List all countries covered by GlobalRules (120+ countries, ~55 verified topics each: VAT, public holidays, tipping, visas, minimum wage...). No wallet or payment needed.
setup_paymentsFREE. How to enable the paid tools (structured JSON, bulk compare, full dataset) with a $1 dedicated wallet in ~2 minutes.
Public scan report
scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 43 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Globalrules compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,243 servers
- Tools
- 7
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 95
- more than 61% of 12,306 servers with a package
What its tools let an agent do: 6 read · 1 change
Install Globalrules in Claude Code, Cursor or VS Code
Runs npx -y globalrules-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add globalrules -- npx -y globalrules-mcp
What the publisher says
From the Globalrules repository's README, as published. We do not edit it. Read it on GitHub
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
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": ["/GlobalRules/mcp/index.mjs"])
- EVMPRIVATEKEY 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:
- Generate a fresh burner key: node -e "console.log(require('viem/accounts').generatePrivateKey())" (or any wallet app's "create new wallet" flow)
- 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)
- Drop the private key into EVMPRIVATEKEY above and run a call — at $0.005–$0.02/call, $5 covers hundreds of requests
- 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
Nothing above is checked by us. What we check is on the safety report.
Globalrules: common questions
- Is Globalrules MCP server safe?
- Mostly: it is graded B (78/100). Read the Globalrules safety report
- How do I install Globalrules?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Globalrules need an API key?
- Yes. The registry entry asks for
EVM_PRIVATE_KEY. - Is Globalrules maintained?
- The last commit was 63 days ago (2026-09-04). The latest release is v1.1.2.
- How does Globalrules compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,243 servers); tools 7 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.