Porkbun MCP Server
oborseth/Porkbun-MCP
Gerenciamento completo de domínios e DNS via Claude e agentes IA
Ver no GitHubServidor MCP oficial que expõe a API v3 da Porkbun como 31 ferramentas nativas para Claude Desktop, Cursor e outros agentes IA. Oferece controle completo do ciclo de vida de domínios (registro, renovação, transferência) e gerenciamento de DNS, DNSSEC, redirecionamentos e registros glue, com proteção contra duplicação em retentativas.
Instalação
npx convez-ai oborseth/Porkbun-MCP1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar registro e renovação de domínios sem UI
- Gerenciar DNS e DNSSEC programaticamente via agentes
- Integrar operações de domínio em workflows de IA
- Monitorar saldo de conta e status de transferências
Veredito

MCP server maduro (v0.3.2) e bem estruturado que leva a Porkbun para agentes IA de forma segura. Implementação profissional com idempotência nativa, cobertura abrangente e documentação clara — recomendado para quem precisa automação de domínios em pipelines IA.
README
A tradução para o português deste README ainda está na fila.
Porkbun MCP Server
A Model Context Protocol server that exposes the Porkbun v3 API as native tools for AI agents — Claude Desktop, Cursor, Cline, and any other MCP-compatible client.
Status: v0.3.2 — covers everything you can do in the Porkbun web UI. All write operations attach an
Idempotency-Keyautomatically, so retries within 24 hours don't double-charge.
What's included (31 tools)
Read tools (free, no spend, no state changes)
| Tool | Description |
|---|---|
ping | Verify API connectivity and credentials |
check_domain | Check availability and pricing for a single domain |
get_pricing | Get registration/renewal/transfer pricing for all TLDs (no auth needed) |
list_marketplace | Browse the Porkbun aftermarket — filter by TLD, max price, name substring |
list_domains | Paginate through domains; filter by tld, expiry, auto-renew, API access |
get_domain | Get metadata for a single domain in the account |
get_balance | Get account credit balance |
get_api_settings | Get monthly spend limit, low-balance alert, auto top-up config, MTD spend |
get_nameservers | Get current nameservers for a domain |
list_dns_records | List DNS records for a domain |
list_dnssec_records | List DNSSEC DS records published at the registry |
list_url_forwards | List URL forwarding rules for a domain |
list_glue_records | List glue records (host-to-IP mappings) for a domain |
list_transfers | List in-progress and recent inbound transfers |
get_transfer_status | Get status of a specific inbound transfer |
get_ssl_bundle | Retrieve the free Porkbun-issued SSL bundle for a domain |
Domain lifecycle writes (spend account credit)
| Tool | Description |
|---|---|
register_domain | Register a new domain — call check_domain first to confirm price |
renew_domain | Renew an existing domain |
transfer_domain | Initiate an inbound transfer (returns transferId; takes 5-7 days) |
Domain settings writes (free)
| Tool | Description |
|---|---|
update_auto_renew | Turn auto-renewal on or off |
update_nameservers | Replace the nameserver list for a domain (full replace, not append) |
DNS / DNSSEC / URL-forwarding / glue writes (free)
| Tool | Description |
|---|---|
create_dns_record | Create a new DNS record (A, AAAA, CNAME, MX, TXT, etc.) |
update_dns_record | Update an existing DNS record by its ID |
delete_dns_record | Delete a DNS record by its ID |
create_dnssec_record | Submit a DNSSEC DS record to the registry |
delete_dnssec_record | Remove a DNSSEC DS record by key tag |
create_url_forward | Create a URL forwarding rule |
delete_url_forward | Delete a URL forwarding rule by ID |
create_glue_record | Create a glue record (host-to-IP mapping at the registry) |
update_glue_record | Replace the IP list for a glue record |
delete_glue_record | Delete a glue record by host |
Install
You'll need Node.js 18 or newer.
npx -y @porkbunllc/mcp-server
This downloads and runs the latest version on demand. No global install needed.
Configure your MCP client
Claude Desktop
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"porkbun": {
"command": "npx",
"args": ["-y", "@porkbunllc/mcp-server"],
"env": {
"PORKBUN_API_KEY": "pk1_your_public_key_here",
"PORKBUN_SECRET_API_KEY": "sk1_your_secret_key_here"
}
}
}
}
Restart Claude Desktop. Porkbun tools should appear in the tool picker.
Cursor / Cline / Continue
Most MCP-aware editors use a similar mcpServers config block. See your client's documentation for the exact location.
Get API keys
Create API keys at porkbun.com/account/api. You'll need both the public key (pk1_…) and the secret key (sk1_…).
By default, API access is opt-in per domain. To use the API to manage all your domains, enable the "Opt In All Domains" toggle in the same settings page. Otherwise you'll need to enable API access for each domain individually under Domain Management.
Recommended: scope the key to your agent
Each API key supports two optional restrictions, set via the gear icon next to the key in porkbun.com/account/api:
- Allowed IPs — one entry per line; supports bare IPv4/IPv6 plus CIDR ranges (
198.51.100.0/24,2001:db8::/32). Requests from other IPs fail with HTTP 403IP_NOT_ALLOWEDbefore any other check runs. - Allowed domains — one entry per line, exact match. Operations against domains not in the list fail with HTTP 403
DOMAIN_NOT_ALLOWED.
Empty fields = no restriction (matches current behavior). When you give an MCP server a key, the recommended pattern is:
- Create a fresh key dedicated to the agent (not your master key).
- List the specific domains the agent should manage.
- If you know the agent's egress IP, list it too.
The blast radius of an accidentally-leaked key drops to "operations on these domains from this IP" instead of "anything on the account."
Environment variables
| Variable | Required | Purpose |
|---|---|---|
PORKBUN_API_KEY | yes | Your Porkbun public API key |
PORKBUN_SECRET_API_KEY | yes | Your Porkbun secret API key |
PORKBUN_BASE_URL | no | Override the API base URL (e.g. for testing against api-betamax.porkbun.com/api/json/v3) |
Local development
git clone https://github.com/oborseth/Porkbun-MCP.git
cd Porkbun-MCP
npm install
npm run build
npm start # or: node dist/index.js
The server speaks JSON-RPC 2.0 over stdio. Smoke test from a shell:
(printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}') \
| PORKBUN_API_KEY=pk1_… PORKBUN_SECRET_API_KEY=sk1_… node dist/index.js
Reliability
All write operations (when added in future releases) will automatically attach a per-call Idempotency-Key header. Retried calls within 24 hours return the cached response — your agent can safely retry on network errors without double-charging.
License
MIT