porkbun-mcp

MCP server for the Porkbun API v3 — 32 tools covering domain registration, DNS management, SSL certificates, email hosting, marketplace, and more.

Installation

npm

npm install -g porkbun-mcp-server

GitHub Packages

npm install -g @eyalm321/porkbun-mcp-server --registry=https://npm.pkg.github.com

Configuration

Set the following environment variables:

export PORKBUN_API_KEY="pk1_..."
export PORKBUN_SECRET_API_KEY="sk1_..."

Get your API keys at porkbun.com/account/api.

Usage with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "porkbun": {
      "command": "npx",
      "args": ["-y", "porkbun-mcp-server"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_API_KEY": "sk1_..."
      }
    }
  }
}

Tools (32)

Utility

• porkbun_ping — Test credentials and get IP
• porkbun_get_ip — Get public IP (no auth)

Pricing

• porkbun_get_pricing — Get domain pricing for all TLDs (no auth)

API Key Management

• porkbun_apikey_request — Initiate API key authorization
• porkbun_apikey_retrieve — Poll for API key approval

Domain (13 tools)

• porkbun_domain_list_all — List all domains
• porkbun_domain_get_ns — Get nameservers
• porkbun_domain_update_ns — Update nameservers
• porkbun_domain_update_auto_renew — Update auto-renew
• porkbun_domain_check — Check availability & pricing
• porkbun_domain_create — Register a domain
• porkbun_domain_add_url_forward — Add URL forward
• porkbun_domain_get_url_forwarding — List URL forwards
• porkbun_domain_delete_url_forward — Delete URL forward
• porkbun_domain_create_glue — Create glue record
• porkbun_domain_update_glue — Update glue record
• porkbun_domain_delete_glue — Delete glue record
• porkbun_domain_get_glue — Get glue records

DNS (11 tools)

• porkbun_dns_retrieve — Retrieve all DNS records
• porkbun_dns_retrieve_by_id — Get record by ID
• porkbun_dns_retrieve_by_name_type — Get records by name/type
• porkbun_dns_create — Create DNS record
• porkbun_dns_edit — Edit record by ID
• porkbun_dns_edit_by_name_type — Edit records by name/type
• porkbun_dns_delete — Delete record by ID
• porkbun_dns_delete_by_name_type — Delete records by name/type
• porkbun_dns_create_dnssec — Create DNSSEC record
• porkbun_dns_get_dnssec — Get DNSSEC records
• porkbun_dns_delete_dnssec — Delete DNSSEC record

SSL

• porkbun_ssl_retrieve — Retrieve SSL certificate bundle

Email Hosting

• porkbun_email_set_password — Set email hosting password

Marketplace

• porkbun_marketplace_list — List marketplace domains

Development

npm install
npm run build
npm test

License

MIT