Porkbun MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with the Porkbun API (v3).

This server allows MCP-compatible clients (like AI assistants, IDE extensions, etc.) to manage Porkbun domains, DNS records, SSL certificates, and more, through a standardized interface.

Tools

1. ping_porkbun

   • Tests the Porkbun API connection and authentication.
   • Inputs: None
   • Returns: Success message including the client's public IP address, or an error message.

2. list_domains

   • Retrieves a list of domains in the Porkbun account.
   • Inputs:
     • start (optional number): Index to start retrieving domains from (default 0).
     • includeLabels (optional enum: "yes"): Include domain labels.
   • Returns: An array of domain objects with details like status, expiration date, etc.

3. get_dns_records

   • Retrieves all DNS records for a specified domain.
   • Inputs:
     • domain (string): The domain name.
   • Returns: An array of DNS record objects.

4. create_dns_record

   • Adds a new DNS record to a specified domain.
   • Inputs:
     • domain (string): The domain name.
     • name (optional string): Subdomain (leave blank for root, * for wildcard).
     • type (string): Record type (A, CNAME, MX, TXT, NS, AAAA, SRV, TLSA, CAA, HTTPS, SVCB).
     • content (string): Record content/answer.
     • ttl (optional number): Time To Live in seconds (default 600, min 600).
     • prio (optional number): Priority (required for MX/SRV records).
   • Returns: Success message with the new record ID.

5. edit_dns_record

   • Modifies an existing DNS record using its ID.
   • Inputs:
     • domain (string): The domain name.
     • record_id (string): The ID of the record to edit.
     • name (optional string): New subdomain.
     • type (string): New record type (A, CNAME, MX, etc.).
     • content (string): New record content/answer.
     • ttl (optional number): New TTL in seconds (default 600, min 600).
     • prio (optional number): New Priority (for MX/SRV records).
   • Returns: Success message.

6. delete_dns_record

   • Removes a specific DNS record using its ID.
   • Inputs:
     • domain (string): The domain name.
     • record_id (string): The ID of the record to delete.
   • Returns: Success message.

7. get_ssl_bundle

   • Retrieves the SSL certificate bundle for a specified domain.
   • Inputs:
     • domain (string): The domain name.
   • Returns: An object containing certificatechain, privatekey, and publickey.

8. update_nameservers

   • Updates the nameservers for a specified domain.
   • Inputs:
     • domain (string): The domain name.
     • ns (array of strings): An array of name server hostnames.
   • Returns: Success message.

9. get_nameservers

   • Gets the authoritative nameservers for a specified domain from the registry.
   • Inputs:
     • domain (string): The domain name.
   • Returns: An array of name server hostnames.

10. add_url_forward

    • Adds URL forwarding for a domain or subdomain.
    • Inputs:
      • domain (string): The domain name.
      • subdomain (optional string): Subdomain to forward (leave blank for root).
      • location (string): URL to forward to.
      • type (enum: "temporary", "permanent"): Type of forward.
      • includePath (optional enum: "yes", "no"): Include URI path in redirection (default "no").
      • wildcard (optional enum: "yes", "no"): Also forward all subdomains (default "no").
    • Returns: Success message.

11. **`get_u

... View full README on GitHub