porkbun

This Porkbun MCP Server exposes a standardized set of tools that allow MCP-compatible clients to manage Porkbun domains, DNS records, SSL certificates, and related domain configurations via the Model Context Protocol. The included tools cover connectivity validation (ping_porkbun), listing domains (list_domains), DNS record management (get_dns_records, create_dns_record, edit_dns_record, delete_dns_record and related helpers), SSL bundle retrieval (get_ssl_bundle), nameserver operations (update_nameservers, get_nameservers), URL forwarding (add_url_forward, get_url_forwarding, delete_url_forward), domain availability checks (check_domain), and DNSSEC management (create_dnssec_record, get_dnssec_records, delete_dnssec_record). This enables automated assistants, IDE extensions, or other MCP clients to perform common Porkbun tasks without manual API calls.

Prerequisites:

• Node.js v18 or later
• npm (comes with Node.js)
• Porkbun API Key and Secret Key

1. Clone the repository git clone https://github.com/miraclebakelaser/porkbun-mcp-server.git cd porkbun-mcp-server

2. Install dependencies npm install

3. Configure API keys You can provide your Porkbun API Key and Secret Key in multiple ways (highest precedence first):

   • System Environment Variables: set PORKBUN_API_KEY and PORKBUN_SECRET_API_KEY in your environment
   • Environment file (optional): create a .env file with PORKBUN_API_KEY and PORKBUN_SECRET_API_KEY
   • Direct configuration within the deployment environment if the server supports it

4. Run the server npm start

5. Optional: run with explicit node command if you know the entry file node server.js

Environment variables are required for authenticating with Porkbun. If you encounter authentication errors, double-check that PORKBUN_API_KEY and PORKBUN_SECRET_API_KEY are correctly set and that the API keys have the necessary permissions. The server exposes a comprehensive set of tools; refer to the README for detailed input parameters for each command. Ensure your Node.js version is compatible (v18+ is recommended) and that network access to Porkbun API endpoints is not blocked by firewalls.