stackgate.ai
Alle integrationer

Porkbun

Forbind Claude, ChatGPT eller Cursor til Porkbun via MCP. Administrer domæner, DNS, registrering, fornyelse og transfers med API key og secret.

Manual setup 49 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Which Porkbun domains can this API key manage?

  • Show the DNS records for example.com.

  • Is testdomain-example.com available, and what does registration cost?

  • Add a dry-run A record for www.example.com pointing at 203.0.113.10.

  • Which domains expire in the next 30 days?

Overblik

Forbind Porkbun, så AI-klienter kan liste domæner, inspicere og redigere DNS og registrere, forny eller transfere domæner - uden at lime API-nøgler ind i prompts.

Register, renew og transfer bruger Porkbun-kredit. Kør altid en dry run først, og bekræft derefter domæne og pris med brugeren.

Forudsætninger

  • En Porkbun-konto med API Access slået til
  • En stackgate.ai-konto
  • Tilstrækkelig Porkbun-kredit, hvis du vil registrere, forny eller transfere

Sådan får du credentials

  1. Log ind på Porkbun og åbn Account → API Access.
  2. Opret en API-nøgle. Kopiér den offentlige API key (pk1_…) og secret API key (sk1_…). Secret vises kun én gang.
  3. Aktivér API-adgang på hvert domæne, du vil styre, eller brug Opt In All Domains.
  4. Lad IP restriction være tom for hub-nøgler. Begræns i stedet med domain-allowlist. stackgate.ai udgiver ikke faste egress-IP'er.
  5. I stackgate.ai: åbn Mine integrationer → Porkbun.
  6. Klik Activate, indsæt API key og secret, og gem. stackgate.ai tester nøglerne med Porkbun /ping, før de gemmes.

Sandbox-nøgler starter med pk1_sb_ / sk1_sb_. Brug dem kun mod Porkbuns sandbox-host.

Se Porkbun API-dokumentationen.

Credentials-reference

Felt Påkrævet Hvor finder du det Bemærkninger
API key Ja Account → API Access Offentlig nøgle, starter med pk1_. Gemmes krypteret.
Secret API key Ja Account → API Access Vises kun ved oprettelse. Gemmes krypteret.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/porkbun med et Sanctum bearer-token
  • Private gateway: én config til alle integrationer - brug porkbun__*-navngivne værktøjer
  • Business gateway: samme namespaced værktøjer, når Porkbun er slået til for virksomheden

Vigtige værktøjer:

  • ping, list_domains, get_domain - bekræft nøgler og find domæner med API-adgang
  • check_domain, get_pricing, get_registration_requirements - tilgængelighed og pris før register
  • list_dns_records, create_dns_record, update_dns_record, delete_dns_record - DNS (name er kun subdomain, aldrig FQDN)
  • register_domain, renew_domain, transfer_domain - bruger kredit; brug dry_run=true først
  • get_ssl_bundle - indeholder en privat nøgle; lim den ikke ind i offentlige chats

Efter connect: brug Edit tool access til at begrænse værktøjer (fx kun DNS, ingen register).

Se Dokumentation for HTTP-autentificering og private gateway.

Test integrationen

List Porkbun-domæner denne API-nøgle kan styre.
Vis DNS-records for example.com.
Tjek om testdomain-example.com er ledigt, og hvad det koster.
Opret en dry-run A-record for www.example.com til 203.0.113.10.

Typiske værktøjer: list_domains, list_dns_records, check_domain, create_dns_record.

Fejlfinding

Problem Sandsynlig årsag Løsning
422 integration not configured Formularen er ikke udfyldt Tilføj API key og secret under Mine integrationer
Porkbun rejected these API keys Forkert nøgle, secret eller API Access slået fra Opret nøglerne igen og bekræft Opt In All Domains eller adgang pr. domæne
403 DOMAIN_NOT_ALLOWED Domænet er ikke opted in til denne nøgle Aktivér API Access på det domæne
403 IP_NOT_ALLOWED Nøglen har IP-allowlist Fjern IP restriction på Porkbun-nøglen; begræns med domain i stedet
429 RATE_LIMIT_EXCEEDED Porkbun rate limit (check_domain er ca. 1 pr. 10 sekunder) Vent Retry-After sekunder; undgå at polle tilgængelighed
DNS-ændring gik ikke live Domænet bruger Cloudflare via Porkbun Porkbun /dns redigerer Porkbuns kopi; live-resolution kan blive på Cloudflare

Sikkerhed og tilbagekaldelse

  • Disconnect i Mine integrationer → Porkbun sletter de gemte nøgler fra stackgate.ai.
  • Tilbagekald eller rotér nøgler i Porkbun Account → API Access.
  • Nøgler gemmes krypteret. Tool calls audit-logges. Nøgler accepteres aldrig som tool-argumenter.

Begrænsninger

  • Register, renew og transfer bruger Porkbun-kredit og skal matche den citerede pris i pennies.
  • check_domain er rate-limiteret (ca. 1 tjek pr. 10 sekunder).
  • Hub-nøgler bør ikke bruge Porkbun IP restriction. Brug domain-allowlists.
  • get_ssl_bundle returnerer en privat nøgle. Behandl den som en hemmelighed.
  • Porkbun hosting, WordPress og Cloudflare-connect-endpoints er ikke eksponeret.

Tilgængelige værktøjer

  • ping

    Bekræft Porkbun API-nøgler og returnér kalderens IP.

  • get_pricing

    Get Porkbun registration, renewal, and transfer pricing across TLDs.

  • check_domain

    Tjek om et domæne er ledigt og returnér aktuelle register-, renew- og transfer-priser.

  • get_registration_requirements

    Get whether a TLD is API-registerable plus the /domain/create payload as JSON Schema and any registry eligibility fields.

  • list_domains

    List domæner på Porkbun-kontoen. Foretræk api_access=yes for nøgler med domain-allowlist.

  • get_domain

    Hent metadata for ét domæne på den forbundne Porkbun-konto.

  • get_balance

    Get Porkbun account credit balance.

  • get_api_settings

    Get monthly API spend-control settings and current-month spend.

  • get_nameservers

    Get the current nameservers for a domain.

  • list_dns_records

    List redigerbare DNS-records for et domæne.

  • get_dns_record

    Get a single DNS record by numeric ID.

  • list_dns_records_by_name_type

    List DNS records for a domain that match a record type and optional subdomain.

  • list_dnssec_records

    List DNSSEC DS records published at the registry for a domain.

  • list_url_forwards

    List URL forwarding rules for a domain.

  • list_glue_records

    List glue records (host-to-IP mappings) for a domain.

  • list_transfers

    List in-progress and recent inbound domain transfers.

  • get_transfer_status

    Get the status of an inbound transfer for a domain.

  • get_ssl_bundle

    Hent Porkbuns gratis SSL-bundle. Svaret indeholder den private nøgle.

  • get_contacts

    Get a domain's registrant, admin, tech, and billing contacts.

  • list_marketplace

    Browse Porkbun aftermarket listings with optional filters.

  • get_webhook_event_types

    List event types a Porkbun webhook endpoint can subscribe to.

  • list_webhooks

    List webhook endpoints (URL, events, status, delivery health).

  • get_webhook

    Get a single webhook endpoint by ID.

  • list_webhook_deliveries

    List recent webhook delivery attempts (about 30 days of history).

  • get_webhook_delivery

    Get a single webhook delivery including the signed payload.

  • register_domain

    Registrer et domæne med Porkbun-kredit. Brug dry_run=true først og bekræft pris.

  • renew_domain

    Forny et domæne med Porkbun-kredit. Bekræft cost og brug dry_run=true først.

  • transfer_domain

    Start en inbound domain-transfer med EPP-kode og matching transfer-pris.

  • update_auto_renew

    Turn auto-renewal on or off for one or more domains.

  • update_nameservers

    Replace the nameserver list for a domain (full replace, not append). Prefer dry_run=true first.

  • update_contacts

    Update domain contacts. Provide contacts (per-role object) or contact (applied to all four roles). Fields: firstName, lastName, organization, address1, address2, address3, city, state, postalCode, country (ISO 3166-1 alpha-2), phone, phoneCountryCode, fax, email.

  • create_dns_record

    Opret en DNS-record. name er kun subdomain (www, * eller tom for apex).

  • update_dns_record

    Edit a DNS record by numeric ID. Prefer dry_run=true before changing live records.

  • delete_dns_record

    Delete a DNS record by numeric ID. Prefer dry_run=true first.

  • update_dns_records_by_name_type

    Replace the content of all DNS records matching a subdomain and type.

  • delete_dns_records_by_name_type

    Delete all DNS records matching a subdomain and type.

  • create_dnssec_record

    Submit a DNSSEC DS record to the registry for a domain.

  • delete_dnssec_record

    Delete a DNSSEC record from the registry by key tag. Most registries delete all records matching the key data.

  • create_url_forward

    Create a URL forwarding rule for a domain or subdomain.

  • delete_url_forward

    Delete a URL forwarding rule by ID.

  • create_glue_record

    Create a glue record (host-to-IP mapping) at the registry.

  • update_glue_record

    Replace the IP list for a glue record.

  • delete_glue_record

    Delete a glue record by host label.

  • create_webhook

    Register an HTTPS endpoint to receive signed Porkbun events. The signing secret is returned once.

  • update_webhook

    Change a webhook endpoint URL, events, or status (ACTIVE or DISABLED).

  • rotate_webhook_secret

    Generate a new signing secret for a webhook endpoint. The new secret is returned once.

  • test_webhook

    Send a webhook.test event to confirm reachability and signature verification.

  • resend_webhook

    Re-queue a past webhook delivery (reuses the original event ID).

  • delete_webhook

    Delete a webhook endpoint.

MCP-endpoint: https://stackgate.ai/mcp/porkbun (HTTP) eller via private gateway.

Opret konto Dokumentation