Globalrules

io.github.yk647Published by GitHub account yk647v1.1.2Updated Oct 25, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceKnowledge & Memory

Overview

AI-generated overview

Serves verified country facts (VAT, holidays, visas and more) for 70 countries, letting an assistant look up, compare and export data, with paid tools billed in

What you can do
List covered countries and get all facts or a single fact for one country. Compare one fact across all covered countries. Retrieve the complete dataset with sources. Free tools cover the country list and country overview; other tools pay automatically in USDC per call.
When to use it
Use it when you need verified country facts such as VAT, holidays, visas, tipping or minimum wages, and are willing to pay per call in USDC on Base. Less suitable if you only need a few free lookups or do not want to use a crypto wallet.
Requirements
Runs locally as an npm package via npx, so Node.js is needed. Paid tools require EVM_PRIVATE_KEY, a Base mainnet wallet private key, with a small USDC balance; free tools work without it. Network access to the GlobalRules API is required, and GLOBALRULES_API can override its base URL.
Before you install
Requires a wallet private key in EVM_PRIVATE_KEY, and each paid tool call spends real USDC (roughly 0.005 to 0.25 per call). Use a dedicated low-balance wallet, never a main wallet. Queries are sent to the third-party GlobalRules API.

Installation

In SourceWeft

  1. Open Globalrules in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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)

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:

  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

Source: README.md at commit 29ffac8

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts