Porkbun MCP Server
@miraclebakelaser
MCP server implementation for managing domains, DNS, and SSL via the Porkbun API.
Overview
What is Porkbun MCP Server?
A Model Context Protocol (MCP) server that provides tools to interact with the Porkbun API (v3). It allows MCP‑compatible clients, such as AI assistants and IDE extensions, to manage Porkbun domains, DNS records, SSL certificates, and more through a standardized interface.
How to use Porkbun MCP Server?
Install Node.js (v18+), clone the repository, run npm install, and configure your Porkbun API key and secret key via environment variables (PORKBUN_API_KEY, PORKBUN_SECRET_API_KEY) or a .env file. Build with npm run build, then start with npm start or node build/index.js. Optionally pass --dotenv-path for a custom .env location. For Claude Desktop, add a configuration entry pointing to build/index.js in claude_desktop_config.json.
Key features of Porkbun MCP Server
- Ping the Porkbun API to test authentication
- List all domains in the account
- Manage DNS records (create, edit, delete, retrieve)
- Retrieve SSL certificate bundles for a domain
- Update and query authoritative nameservers
- Add, list, and delete URL forwarding rules
Use cases of Porkbun MCP Server
- Automate DNS record changes across many domains
- Quickly check domain availability and pricing
- Retrieve SSL certificates programmatically
- Programmatically update nameservers for domain migration
FAQ from Porkbun MCP Server
What are the prerequisites?
Node.js v18 or later, npm, and a Porkbun API key and secret key (generate at your Porkbun account API page).
How do I provide API keys?
You can set system environment variables (PORKBUN_API_KEY, PORKBUN_SECRET_API_KEY), create a .env file in the project root, or specify a custom .env path with the --dotenv-path argument.
How do I run the server in development mode?
Use npm run dev. To pass arguments like --dotenv-path, run npm run dev -- --dotenv-path /path/to/your/.env.
What transport does the server use?
The server communicates over MCP stdio transport (standard input/output).
Is the server open source? What license?
Yes, it is licensed under the MIT License.
