Server data from the Official MCP Registry
Verified country facts (VAT, holidays, visas; 114 countries). Free + paid (x402 USDC) tools.
About
Verified country facts (VAT, holidays, visas; 114 countries). Free + paid (x402 USDC) tools.
Security Report
This is a well-designed MCP server for accessing GlobalRules country data with integrated x402 micropayments. The code properly handles optional authentication (EVM private key), validates input, and gracefully degrades when credentials are missing. A minor info-level concern exists around private key format validation regex, but overall the implementation follows security best practices for its use case. Supply chain analysis found 7 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
3 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: EVM_PRIVATE_KEY
Environment variable: GLOBALRULES_API
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-yk647-globalrules": {
"env": {
"EVM_PRIVATE_KEY": "your-evm-private-key-here",
"GLOBALRULES_API": "your-globalrules-api-here"
},
"args": [
"-y",
"globalrules-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
| 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.
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_KEYis 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
EVM_PRIVATE_KEYabove 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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption