English Français العربية

io.github.yk647/globalrules

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package globalrules-mcp
Claude Code 
claude mcp add globalrules -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'GLOBALRULES_API=<GLOBALRULES_API>' -- npx -y globalrules-mcp@1.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "globalrules": {
            "command": "npx",
            "args": [
                "-y",
                "globalrules-mcp@1.1.2"
            ],
            "env": {
                "EVM_PRIVATE_KEY": "<your evm_private_key>",
                "GLOBALRULES_API": "<GLOBALRULES_API>"
            }
        }
    }
}

متغيرات البيئة

  • EVM_PRIVATE_KEY سري Optional. 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_API Optional override of the GlobalRules API base URL. Default: https://globalrules-api.onrender.com

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. globalrules-mcp
  2. Tools
  3. Setup (Claude Desktop)
  4. How it works

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

الأسئلة الشائعة

ما هو io.github.yk647/globalrules؟

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

كيف أثبّت io.github.yk647/globalrules؟

يعمل على جهازك. في Claude Code: claude mcp add globalrules -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'GLOBALRULES_API=<GLOBALRULES_API>' -- npx -y globalrules-mcp@1.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.yk647/globalrules إلى مفتاح API؟

نعم. يتطلب EVM_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.yk647/globalrules مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.yk647/globalrules؟

ينشره yk647. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.