porkbun-mcp
About
MCP server for Porkbun domains and DNS
Details
- Author
- korobkov-v
- Categories
- Other, Infrastructure
Jump to
Setup
Install porkbun-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/korobkov-v/porkbun-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
- domains and nameservers
- DNS records
- DNSSEC
- SSL certificate bundle
- URL forwarding
- read-only behavior by default
- mutating tools require explicit write mode
- scenario tools default todry_run: true
Porkbun operations are often repetitive and risky under time pressure. This project exposes Porkbun APIs as MCP tools so AI assistants can execute domain workflows consistently and with guardrails.
- Node.js>=20
- Porkbun API credentials:
- PORKBUN_API_KEY
- PORKBUN_SECRET_KEY
- Log in to Porkbun.
- Open account settings and go to API Access.
- Generate/copy:
- PORKBUN_API_KEY(API Key)
- PORKBUN_SECRET_KEY(Secret API Key)
Install dependencies locally (for development):
PORKBUN_API_KEY=your_key \ PORKBUN_SECRET_KEY=your_secret \ node dist/index.js
PORKBUN_API_KEY=your_key \ PORKBUN_SECRET_KEY=your_secret \ PORKBUN_GET_MUDDY=true \ node dist/index.js --get-muddy
GitHub README does not support native tabs, so this section uses collapsible "tab-like" blocks. If you later move docs to a docs site (Docusaurus/Nextra), you can reuse the same snippets as real tabs.
{ "porkbun-mcp": { "command": "npx", "args": ["-y", "porkbun-mcp"], "env": { "PORKBUN_API_KEY": "your_porkbun_api_key", "PORKBUN_SECRET_KEY": "your_porkbun_secret_api_key" } } }
Add an MCP server in Cursor settings and paste the snippet above as a server config. If your setup expects an outer object, wrap it into:
{ "mcpServers": { "porkbun-mcp": { "command": "npx", "args": ["-y", "porkbun-mcp"], "env": { "PORKBUN_API_KEY": "your_porkbun_api_key", "PORKBUN_SECRET_KEY": "your_porkbun_secret_api_key" } } } }
Update~/Library/Application Support/Claude/claude_desktop_config.json:
{ "mcpServers": { "porkbun-mcp": { "command": "npx", "args": ["-y", "porkbun-mcp"], "env": { "PORKBUN_API_KEY": "your_porkbun_api_key", "PORKBUN_SECRET_KEY": "your_porkbun_secret_api_key" } } } }
Most clients use the samemcpServersshape:
{ "mcpServers": { "porkbun-mcp": { "command": "npx", "args": ["-y", "porkbun-mcp"], "env": { "PORKBUN_API_KEY": "your_porkbun_api_key", "PORKBUN_SECRET_KEY": "your_porkbun_secret_api_key" } } } }
{ "mcpServers": { "porkbun-mcp": { "command": "npx", "args": ["-y", "porkbun-mcp", "--get-muddy"], "env": { "PORKBUN_API_KEY": "your_porkbun_api_key", "PORKBUN_SECRET_KEY": "your_porkbun_secret_api_key" } } } }
{ "mcpServers": { "porkbun-mcp": { "command": "npx", "args": ["-y", "porkbun-mcp", "--get-muddy", "--enable-domain-create"], "env": { "PORKBUN_API_KEY": "your_porkbun_api_key", "PORKBUN_SECRET_KEY": "your_porkbun_secret_api_key" } } } }
Important (Porkbun API domain registration prerequisites):
- Your Porkbun account must have registered at least one domain in the past (for new accounts, the first purchase may need to be done via the web UI).
- Your email address and phone number must be verified.
- You must have enough account credit (API registrations are billed from account credit).
- costmust be provided in pennies and must match the value returned by the domain check (minimum duration * price).
- You must explicitly accept terms (agree_to_terms=truein this server, which maps toagreeToTerms="yes"for Porkbun).
- Porkbun API v3 docs (see "Domain Create" and "Domain Check"):https://porkbun.com/api/json/v3/documentation
Once configured in your MCP client, start with:
Before any write call, run a scenario tool indry_runmode first.
- Write actions are blocked unless--get-muddyorPORKBUN_GET_MUDDY=trueis set.
- Scenario tools are designed to plan before apply.
- Destructive tools include explicit limits and confirmations.
- API credentials are account-level. Domain-level API permissions in Porkbun still apply.
- Domain registration (domains_create) is disabled by default. It requires:
- write mode (--get-muddy)
- explicit enable flag (--enable-domain-createorPORKBUN_ENABLE_DOMAIN_CREATE=true)
- dry_run=false+confirm_apply=true+agree_to_terms=true
- PORKBUN_API_KEY(required)
- PORKBUN_SECRET_KEY(required)
- PORKBUN_GET_MUDDY(optional)
- PORKBUN_ENABLE_DOMAIN_CREATE(optional, dangerous)
- --get-muddy
- --enable-domain-create(dangerous)
- --transport stdio
- --ipv4-only-api
- --help
Without it, the server stays in safe read-only behavior. With it, mutating tools are allowed (create/edit/delete/update operations for DNS and domain settings).
- you are ready to apply real infrastructure changes
- your domain is API-enabled in Porkbun
- you have already validated the plan with read calls ordry_runflows
- Connectivity:ping,pricing_get
- Domains: list, nameservers, URL forwarding, glue records (get/create/update/delete), availability
- DNS: list/get/create/edit/delete (including by name/type)
- DNSSEC: list/create/delete
- SSL: certificate bundle retrieval
- dns_query
- dns_upsert
- domain_health_check
- dns_remove
- domain_redirect_ensure
- domain_cutover_web
- dns_batch_apply
- dns_audit
- dns_setup
- email_dns_setup
- update_server_ip
- subdomain_setup
{ "domain": "example.com", "selector": { "record_id": "123456789" } }
{ "domain": "example.com", "match": { "type": "A", "subdomain": "www" }, "target": { "content": "203.0.113.10", "ttl": 300 }, "dry_run": true }
{ "domains": ["example.com", "example.net", "example.org"], "concurrency": 1, "respect_limits": true, "delay_ms": 11000, "stop_on_rate_limit": true }
{ "domain": "example.com", "desired_records": [ { "type": "A", "subdomain": "", "content": "198.51.100.42", "ttl": 300 } ], "mode": "plan", "strategy": "merge", "max_changes": 5 }
- Never commit real API keys to git.
- Prefer local environment variables or a secret manager.
- Treat write mode as production access.
Contributions are welcome. ReadCONTRIBUTING.mdbefore opening a PR.
The Fabric MCP server exposes the following MCP tools that allow AI assistants to interact with your Equinix Fabric resources. Each tool corresponds to a specific Fabric API endpoint.
KHEPRA MCP Server smithery badge MCP Registry License Container PQC Sovereign compliance engine with 36,195 STIG/CCI/NIST/CMMC mappings. Air-gappable. Zero token costs. Run ert_scan → get a Godfather Report with dollar-denominated business impact. The only MCP compliance server that runs on your metal — with the World's First DoD PQC STIG built in. PQC-01-STIG-V1R1 — Full Whitepaper → 17 controls covering CNSA 2.0, FIPS 203/204/205, and the NSA's May 2026 MCP security advisory. The world's first DoD-style Post-Quantum Cryptography STIG, including the first PQC controls for agentic AI and MCP deployments.
Secure Zero-Trust SSH Gateway for AI Agents. A Go-based Model Context Protocol (MCP) server featuring runtime Regex Command Firewalls and multi-host isolation.
Register, manage, and renew domain names directly from AI agents. Supports domain search, purchase, DNS management, and wallet operations.
Secure every MCP server with one governed gateway. Give each AI agent its own scoped MCP access, contain credentials at the gateway, and audit every MCP tool call without wiring agents directly to each server.
Catalog of official Microsoft MCP (Model Context Protocol) server implementations for AI-powered data access and tool integration
claw machine gives any agent access to the users local scoped docker socket.
MCP server for generating cloud architecture diagrams, flowcharts, sequence diagrams, and more — powered by mingrammer/diagrams, Mermaid, and PlantUML.
Civilian situational awareness for AI deployments — real-time risk dashboards, multi-source threat correlation, anomaly detection, and automated alerting for critical infrastructure and enterprise AI systems.
Read-only MCP server inside a self-hosted homelab dashboard — explore hosts, Docker containers, GPU/VRAM, systemd services, AI models, alerts and disk.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



