porkbunMCP

The official MCP server from Porkbun, the domain registrar

Talk to your registrar.

Built, hosted and maintained by Porkbun, the official MCP server connects ChatGPT, Claude, Cursor, or any MCP client straight to your account. Ask in plain language; it registers domains, edits DNS, provisions hosting and moves zones to Cloudflare for you.

https://mcp.porkbun.com/mcp Hosted · no install

Add this URL as a connector, sign in to Porkbun and approve. Nothing to install and no API key to copy. Steps for each app.

Or run it yourself

npx @porkbunllc/mcp-server Node 18+

Free and open source. Works with the API keys you already have — create one here, or let your assistant ask for one (request_api_key: you approve it in your browser, with only the permissions you choose), or try it with no credentials at all.

You askRegister skaboink.dev if it's under $20, point it at my server, and turn auto-renew on.

  1. check_domainskaboink.dev is available — $12.00/yr
  2. register_domainregistered, order recorded
  3. create_dns_recordA · skaboink.dev → 203.0.113.10
  4. update_auto_renewauto-renew on

You get backRegistered skaboink.dev for $12.00, pointed it at 203.0.113.10, and turned auto-renew on.

Real tool names. Every step above is one call your agent makes on your behalf.

What it can do

The whole Porkbun API v3.62, exposed as tools. Each one carries a read-only or destructive hint, so a client can tell a lookup from something that spends money.

Domains

Availability, pricing, registration, renewal, transfers, contacts, nameservers, glue, URL and email forwarding, mailboxes, expired-domain closeouts, and searching taken names that are for sale on the aftermarket. Purchases can be paid from account credit, directly in USDC over x402 (signed by the server itself when a local install has a wallet), or by card from a Stripe Link wallet, held and charged only if the purchase succeeds.

Cloudflare

Move domains to a customer's own Cloudflare account, then manage those records, the proxy and zone settings.

Webhooks

Signed, real-time events for registrations, renewals, transfers, expiring domains, DNS changes, Cloudflare moves and account verification, instead of polling. What each event sends.

Hosting

Provision static hosting or a managed WordPress site, deploy files, and mint WordPress credentials for an agent.

DNS

Full CRUD over records and DNSSEC on Porkbun's nameservers, plus scan-and-import so a transferred domain keeps resolving.

SSL, account, sandbox

Certificate bundles, balance, spend limits, email and phone verification and account credit top-ups (a saved card, the user's card through their agent wallet over MPP, or USDC over x402), plus docs search and sandbox controls.

Official, and first-party

Porkbun makes this server. Here is how to tell it from the others.

Does Porkbun have an official MCP server?

Yes, this one. Porkbun builds, hosts and maintains it. Connect ChatGPT, Claude or any remote-MCP client to https://mcp.porkbun.com/mcp, or run it locally with npx @porkbunllc/mcp-server.

Are the other Porkbun MCP servers on GitHub and in MCP directories official?

No. Several community projects wrap the public Porkbun API. They are built by third parties and are not reviewed or supported by Porkbun. The official server is the one hosted at mcp.porkbun.com and published on npm as @porkbunllc/mcp-server.

Can it register domains, or only search?

It runs the whole account: availability and pricing, registration, renewal, transfers, DNS, SSL, hosting and Cloudflare. Dry runs, spend limits and confirmation come before anything is bought.

Does it cost anything?

No. The server and the hosted connector are free. Domains and services it buys are charged at normal Porkbun prices.

Set it up

Connect an app to the hosted server with a sign-in (or with an API key, for clients that can't sign in), or run the server on your own machine with an API key.

ChatGPT and Claude: hosted, no install

The URL, for every app:

https://mcp.porkbun.com/mcp
  1. Claude, quickest: open Porkbun in the Claude directory and click Connect. That is the no-purchases version (see Choose an endpoint); for everything, add the custom connector as in the next step.
  2. Claude (claude.ai, Desktop): Customize → Connectors → + → Add custom connector. Paste the URL, click Add, then Connect, and click Allow Claude on the Porkbun page. In a chat, turn it on from + → Connectors. (Team and Enterprise: an owner adds it under Organization settings → Connectors → Add → Custom → Web; members then click Connect.)
  3. ChatGPT: Settings → Security and login → turn on Developer mode. Then Plugins → +, name it Porkbun, paste the URL as a public endpoint, create it, and click Allow ChatGPT on the Porkbun page. In a chat, add it from the tools menu.
  4. Claude Code: run the command below, then /mcp, select porkbun, and authenticate in the browser.
claude mcp add --transport http --scope user porkbun https://mcp.porkbun.com/mcp

Any client that supports remote MCP with OAuth works with the bare URL. Each connection is its own API key, listed under API access as “(connected app)”: set its allowed domains to limit it, or disable it to disconnect. It can do what you choose when you sign in (full access, manage but no purchases, or read-only), within your per-domain API access, monthly spend limit and top-up caps. Every tool is available except the sandbox controls. Want an assistant that can't spend money? See Choose an endpoint. Client can't do OAuth? Send your own API key pair as X-API-Key and X-Secret-API-Key headers instead (no IP restriction on that key). Full guide.

Claude Code (local, with an API key)
claude mcp add porkbun \
  --env PORKBUN_API_KEY=pk1_... \
  --env PORKBUN_SECRET_API_KEY=sk1_... \
  -- npx -y @porkbunllc/mcp-server
Claude Desktop (local, with an API key)
{
  "mcpServers": {
    "porkbun": {
      "command": "npx",
      "args": ["-y", "@porkbunllc/mcp-server"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_API_KEY": "sk1_..."
      }
    }
  }
}

Add this to claude_desktop_config.json. On macOS, Claude Desktop launches with a limited PATH — if npx is not found, use the absolute path that which npx prints.

Cursor and other MCP clients

Cursor, one click: Add Porkbun to Cursor (opens Cursor and adds the hosted server; you sign in with Porkbun on first use, no API key). Or run it locally with your keys:

{
  "mcpServers": {
    "porkbun": {
      "command": "npx",
      "args": ["-y", "@porkbunllc/mcp-server"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_API_KEY": "sk1_..."
      }
    }
  }
}

Any client that speaks MCP over stdio will work with the same command. Run locally, your keys never leave your machine.

Point your coding agent at the docs instead

Hand an agent /llms/agent-setup and it will install this server, ask you for scoped credentials, and learn the safety rules on its own.

Choose an endpoint

The hosted server has three addresses. They share the same sign-in, account and connection; the address only decides which tools your assistant is offered, not what the connection is allowed to do.

Hosted MCP endpoints and what each includes
EndpointIncludesLeaves outUse it for
https://mcp.porkbun.com/mcp Everything: domains, DNS, URL and email forwarding, mailboxes, glue, DNSSEC, restore points, SSL, hosting, webhooks, Cloudflare, buying with account credit, and top-ups Only the sandbox tools, which need a sandbox key (run the npm package with one) Adding Porkbun yourself. The default
https://mcp.porkbun.com/mcp/no-purchases Managing what you own: domains, DNS, forwarding, glue, DNSSEC, restore points, hosting sites, webhooks, Cloudflare Anything that buys or charges (registering, renewing, transferring, closeouts, new hosting, credit, auto-renew), secrets (SSL private keys, WordPress and mailbox passwords, webhook signing secrets, new API keys), and, for now, a few newer tools (invoices, email forwarding, mailboxes, email and phone verification) The version in the ChatGPT and Claude app directories. Also for an assistant that should never spend money: a connection signed in here can only be given permissions that cannot buy or add credit, enforced by the API
https://mcp.porkbun.com/mcp/no-topups Everything, including buying with credit already on your account Charging your card for credit, changing auto top-up, and paying a purchase directly by card or USDC An assistant that may buy but must never charge a card

Installed Porkbun from an app directory and need something it leaves out? Add the endpoint you want as a custom connector using the steps above; you can remove the directory version afterwards.

Pointing an agent at your domains

Domains are load-bearing: DNS mistakes take sites and mail offline, and registrations spend real money. The guardrails are in the API itself, so they hold no matter which client is driving.

Rehearse before committingBillable and destructive calls take a dry run that validates everything and changes nothing.
Retries can't double-chargeWrites carry an idempotency key automatically; a repeat replays the original result.
Scope a key to what you meanRestrict an API key to specific domains and source IPs. Out-of-policy calls are refused.
Cap what it can spendOne monthly limit covers what it buys and the credit it adds, $100 a month until you set your own. Only you can change it, on the website.
Prices that can't be misreadEvery money parameter is in cents and says so in its name (cost_cents: 1108 is $11.08), so an approval prompt shows the real amount.
Purchases use credit, not your saved cardBuying spends prepaid account credit. A card is charged only on a top-up you approve, auto top-up you set up yourself, or a purchase you approve paying from your Stripe Link wallet (held, and charged only if it succeeds).
Labelled actionsEvery tool declares whether it only reads, and whether it destroys something, so a client can prompt you before the risky ones.
Errors that say what to doFailures return a stable code and a next step, so an agent recovers instead of guessing.

Try it without credentials

Three ways to see it work before you trust it with a real domain.

Search the docssearch_docs and read_doc need no API key at all.
Mock any endpointmock_call returns a schema-accurate example response for any endpoint.
A real sandboxA pk1_sb_ key runs the whole API against an isolated environment with fake credit — no registry actions, no charges, and webhooks still fire.

Listed on

Other Porkbun MCP servers exist; these listings are the official one, maintained by Porkbun.