Globalrules

Verified country facts (VAT, holidays, visas; 114 countries). Free + paid (x402 USDC) tools.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "globalrules-2": {
      "command": "npx",
      "args": [
        "-y",
        "globalrules-2"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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)

config.json

{
  "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:

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_KEY 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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Globalrules

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "globalrules": { "command": "npx", "args": ["-y", "globalrules"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/globalrules-2?style=directory)](https://allmcps.com/mcp/globalrules-2)

HTML Embed

<a href="https://allmcps.com/mcp/globalrules-2"><img src="https://allmcps.com/api/badge/globalrules-2?style=directory" alt="Globalrules on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Globalrules →Install in Claude Desktop Install in Cursor Install in VS Code