
Porkbun MCP
io.github.korobkov-v由 GitHub 帳號 korobkov-v 發布v0.3.4更新於 Oct 27, 2026
MCP server for Porkbun domains and DNS.
發布方自己的服務:Porkbun (official)
概覽
本機 MCP 伺服器,讓助理檢視與管理 Porkbun 網域、DNS 記錄、DNSSEC、SSL 憑證包與 URL 轉址,預設為唯讀。
- 可以做什麼
- 檢查連線與價格,查詢網域可用性,包含批次查詢。
- 列出網域與名稱伺服器,讀取或管理 URL 轉址和膠水記錄。
- 列出、取得、建立、編輯與刪除 DNS 記錄,支援依名稱與類型查找。
- 列出、建立與刪除 DNSSEC 記錄,並取得 SSL 憑證包。
- 提供情境與輔助工具:規劃 DNS 變更、稽核記錄、設定郵件 DNS、子網域或伺服器 IP 更新,並支援預設 dry_run 的批次套用。
- 適用情境
- 當你希望助理稽核或修改託管於 Porkbun 的網域 DNS、規劃切換或轉址,或在對話中查詢網域可用性與價格時適用。
- 執行需求
- 需要 Node.js 20 或更新版本,以 stdio 方式在本機執行(例如透過 npx)。需要已開啟 API 存取權的 Porkbun 帳戶,以及 PORKBUN_API_KEY 與 PORKBUN_SECRET_KEY 憑證;每個目標網域須在 Porkbun 面板中標示為可透過 API 存取。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Porkbun MCP,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
porkbun-mcp
MCP server for Porkbun domains and DNS.
Use it from any MCP-compatible client to inspect and manage:
- domains and nameservers
- DNS records
- DNSSEC
- SSL certificate bundle
- URL forwarding
Built for safe operations:
- read-only behavior by default
- mutating tools require explicit write mode
- scenario tools default to
dry_run: true
Why This Exists
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.
3-Minute Setup
1) Prerequisites
- Node.js
>=20 - Porkbun API credentials:
PORKBUN_API_KEYPORKBUN_SECRET_KEY
- In Porkbun panel, the target domain must be marked as API accessible ("available via API"). Account-level keys are not enough if domain-level API access is disabled.
Where to get the keys:
- 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)
- In the domain settings, ensure API access is enabled for each domain you want to manage.
Install dependencies locally (for development):
2) Quick local run (stdio)
Read-only mode:
Enable write operations:
3) Verify CLI wiring
MCP Client Integrations
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.
Base server snippet (safe read-only)
Cursor
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:
Claude Desktop (macOS)
Update ~/Library/Application Support/Claude/claude_desktop_config.json:
Other MCP clients (Windsurf, Cline, etc.)
Most clients use the same mcpServers shape:
Write mode with npx
Domain create enabled (dangerous)
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).
Reference:
- Porkbun API v3 docs (see "Domain Create" and "Domain Check"): https://porkbun.com/api/json/v3/documentation
First Successful Call
Once configured in your MCP client, start with:
pingpricing_get
Then try one read flow:
dns_listfor your domain
Before any write call, run a scenario tool in dry_run mode first.
Safety Model
- 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
- write mode (
Environment Variables
PORKBUN_API_KEY(required)PORKBUN_SECRET_KEY(required)PORKBUN_GET_MUDDY(optional)PORKBUN_ENABLE_DOMAIN_CREATE(optional, dangerous)
CLI Options
--get-muddy--enable-domain-create(dangerous)--transport stdio--ipv4-only-api--help
What --get-muddy Means
--get-muddy enables write mode.
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).
Use this mode only when:
- you are ready to apply real infrastructure changes
- your domain is API-enabled in Porkbun
- you have already validated the plan with read calls or
dry_runflows
Tool Coverage
- 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
Scenario tools:
dns_querydns_upsertdomain_health_checkdns_removedomain_redirect_ensuredomain_cutover_webdns_batch_apply
Beginner helpers:
dns_auditdns_setupemail_dns_setupupdate_server_ipsubdomain_setup
Detailed docs: docs/scenario-tools.md
Practical Examples
dns_query by record id:
dns_upsert plan mode:
domains_check_bulk:
dns_batch_apply plan:
Security Notes
- Never commit real API keys to git.
- Prefer local environment variables or a secret manager.
- Treat write mode as production access.
Development
Run locally:
Contributing
Contributions are welcome.
Read CONTRIBUTING.md before opening a PR.
License
MIT
Strict tool arguments and registration cost
All tools reject undeclared arguments. Calls that previously ignored extra fields now fail validation before contacting Porkbun.
For dns_get_by_name_type, dns_edit_by_name_type, and dns_delete_by_name_type, use subdomain, not name. Omit it or pass an empty string to target the zone apex. dns_create and dns_edit use name.
domains_create.cost is an integer in US cents matching the current quote.
The default dry_run: true only returns a local plan and does not check availability or price with Porkbun. Execution requires dry_run: false, confirm_apply: true, agree_to_terms: true, write mode and domain-create enablement.
Run npm test for MCP regression checks with mocked HTTP and no real purchases.
Card payment (0.4.0)
Use pay_with: "card" on domains_create. Before a live call, generate and save
idempotency_key (16–128 ASCII letters, digits, underscores or hyphens; UUIDs work).
The caller must retain the exact request and key across restarts. No durable server
ledger or automatic key generation is provided. Dry-run stays local and defaults
to true. Existing write, registration, terms and confirmation gates still apply.
A 402 returns a flat PAYMENT_REQUIRED result with payUrl, cardPaymentId and
expiresAt. The account holder approves the exact purchase in an external MPP
wallet. This server never pays links or switches to credit. Treat the URL and
payment id as sensitive and avoid sharing histories containing them.
After authorization, repeat the purchase with card_payment_id, explicit card
mode and a NEW saved key because the body changed. Identical retries, including
after lost responses, use the original key. Porkbun documents a 24-hour replay
window; reconcile older or uncertain requests before attempting another purchase.
Timeouts and malformed responses report unknown outcome, never an invented no-charge result. Card responses use an allowlist; raw messages, arbitrary fields and card details are omitted. Only explicit payment booleans are retained on API errors. Responses are capped at 64 KiB, redirects refused, and payment URLs restricted to HTTPS on porkbun.com under /pay/, without credentials, query or fragment. Unsupported shapes fail closed. Existing credit calls retain their response wrapper.
Official contract: https://porkbun.com/llms/guides/pay-with-card-mpp Validation uses mocked HTTP only; no live payments were made.
來源:README.md,提交 db9bcfb
工具
0版本歷史
1- v0.3.4最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
其他 Porkbun 整合
Porkbun (official)
com.porkbun官方發布者
Porkbun 官方 MCP 伺服器,讓 AI 助理查詢、購買與管理網域、DNS、移轉、SSL 及靜態代管。
Porkbun
com.foreverworks
在Porkbun註冊網域並管理DNS、主機和郵件,每筆購買均需先確認。AI 翻譯

Porkbun DNS 🐷
由 GitHub 帳號 major 發布
本機 MCP 伺服器,讓助理透過 Porkbun API 管理 DNS 記錄、網域、DNSSEC 與 SSL 憑證。