oborseth/Porkbun-MCP

npx -y @porkbunllc/mcp-server

Usage

• •Add to Claude Desktop with PORKBUN_API_KEY and PORKBUN_SECRET_API_KEY env vars, or omit the env block to use only the credential-free documentation tools.
• •Test safely with a sandbox key (pk1_sb_/sk1_sb_) — every tool runs against a simulated environment with fake credit, or mint one instantly with create_sandbox_key (no signup).
• •Scope a dedicated key to your agent: list the specific domains it may manage and, if known, its egress IP.
• •For DNS/hosting/domain operations, call check_domain/get_pricing first; write operations attach an Idempotency-Key for safe retries.

Key features

• ✓Full Porkbun v3 coverage: domain lifecycle, DNS/DNSSEC/URL-forward/glue records, SSL bundles, secure static hosting, webhooks (signed HMAC payloads), contacts.
• ✓Credential-free docs tools (list_doc_topics / read_doc / search_docs) let an agent ground itself in Porkbun's own docs mid-conversation.
• ✓Sandbox mode simulates registrations, renewals, transfers, DNS, contacts, glue and DNSSEC with no real registry actions or charges, including signed webhooks.
• ✓mock_call returns schema-accurate example responses for any endpoint with no key required.
• ✓Local thin client that relays directly to api.porkbun.com with no telemetry and keys kept only in memory.

Best for

Anyone using Porkbun who wants to manage domains, DNS and hosting from AI agents, with a safe sandbox to experiment before live spend.

Caveats

• ⚠Some tools spend account credit (register_domain, renew_domain, transfer_domain, create_hosting); hosting first provision is a 15-day free trial that auto-renews.
• ⚠API access is opt-in per domain unless 'Opt In All Domains' is enabled.
• ⚠Hosting and email endpoints are not simulated in sandbox and return SANDBOX_UNSUPPORTED.
• ⚠Requires Node.js 18+; MIT licensed.