porkbun-mcp-server 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,7 +18,7 @@ npm install -g @eyalm321/porkbun-mcp-server --registry=https://npm.pkg.github.co
18
18
 
19
19
  ## Configuration
20
20
 
21
- ### Single account (default)
21
+ ### Single account
22
22
 
23
23
  ```bash
24
24
  export PORKBUN_API_KEY="pk1_..."
@@ -29,14 +29,11 @@ Get your API keys at [porkbun.com/account/api](https://porkbun.com/account/api).
29
29
 
30
30
  ### Multiple accounts
31
31
 
32
- Define additional credential pairs with a `_<USER>` suffix. The user identifier is uppercased; non-alphanumeric characters become underscores.
32
+ You can configure additional accounts using either approach (mix and match if you want):
33
33
 
34
- ```bash
35
- # Default account (used when no `user` is passed)
36
- export PORKBUN_API_KEY="pk1_..."
37
- export PORKBUN_SECRET_API_KEY="sk1_..."
34
+ **Option A: suffixed env vars** (no quoting hassle)
38
35
 
39
- # Per-user accounts
36
+ ```bash
40
37
  export PORKBUN_API_KEY_ALICE="pk1_..."
41
38
  export PORKBUN_SECRET_API_KEY_ALICE="sk1_..."
42
39
 
@@ -44,6 +41,20 @@ export PORKBUN_API_KEY_ACME_CORP="pk1_..."
44
41
  export PORKBUN_SECRET_API_KEY_ACME_CORP="sk1_..."
45
42
  ```
46
43
 
44
+ The user identifier is the suffix, lowercased — so `PORKBUN_API_KEY_ACME_CORP` is selected with `"user": "acme_corp"` (or `"acme-corp"`, since matching is case- and separator-insensitive at lookup time).
45
+
46
+ **Option B: `PORKBUN_ACCOUNTS` JSON array**
47
+
48
+ ```bash
49
+ export PORKBUN_ACCOUNTS='[
50
+ { "user": "default", "PORKBUN_API_KEY": "pk1_...", "PORKBUN_SECRET_API_KEY": "sk1_..." },
51
+ { "user": "alice", "PORKBUN_API_KEY": "pk1_...", "PORKBUN_SECRET_API_KEY": "sk1_..." },
52
+ { "user": "acme-corp", "PORKBUN_API_KEY": "pk1_...", "PORKBUN_SECRET_API_KEY": "sk1_..." }
53
+ ]'
54
+ ```
55
+
56
+ The `apiKey` / `secretApiKey` shorthand aliases are also accepted inside the JSON.
57
+
47
58
  Then pass `user` to any authenticated tool:
48
59
 
49
60
  ```jsonc
@@ -53,11 +64,16 @@ Then pass `user` to any authenticated tool:
53
64
  // Use Alice's credentials
54
65
  { "name": "porkbun_domain_list_all", "arguments": { "user": "alice" } }
55
66
 
56
- // Identifiers are case-insensitive; `acme-corp` matches PORKBUN_API_KEY_ACME_CORP
57
- { "name": "porkbun_domain_list_all", "arguments": { "user": "acme-corp" } }
67
+ // User identifiers are case-insensitive
68
+ { "name": "porkbun_domain_list_all", "arguments": { "user": "Acme-Corp" } }
58
69
  ```
59
70
 
60
- Use `porkbun_list_users` to discover which user identifiers are configured in the running server.
71
+ Resolution rules:
72
+
73
+ - The default account (used when `user` is omitted) is `PORKBUN_API_KEY` / `PORKBUN_SECRET_API_KEY`, or the `PORKBUN_ACCOUNTS` entry with `user: "default"`.
74
+ - A `user` argument matches a configured account by lowercased identifier.
75
+ - Sources are merged — if the same user appears in multiple sources, `PORKBUN_ACCOUNTS` wins over suffixed env vars.
76
+ - Use `porkbun_list_users` to discover which user identifiers are configured.
61
77
 
62
78
  ## Usage with Claude Desktop
63
79
 
@@ -73,7 +89,9 @@ Add to your Claude Desktop config (`claude_desktop_config.json`):
73
89
  "PORKBUN_API_KEY": "pk1_...",
74
90
  "PORKBUN_SECRET_API_KEY": "sk1_...",
75
91
  "PORKBUN_API_KEY_ALICE": "pk1_...",
76
- "PORKBUN_SECRET_API_KEY_ALICE": "sk1_..."
92
+ "PORKBUN_SECRET_API_KEY_ALICE": "sk1_...",
93
+ "PORKBUN_API_KEY_ACME_CORP": "pk1_...",
94
+ "PORKBUN_SECRET_API_KEY_ACME_CORP": "sk1_..."
77
95
  }
78
96
  }
79
97
  }
@@ -131,7 +149,7 @@ Add to your Claude Desktop config (`claude_desktop_config.json`):
131
149
  ### Marketplace
132
150
  - `porkbun_marketplace_list` — List marketplace domains
133
151
 
134
- Every authenticated tool accepts an optional `user` parameter that selects which `PORKBUN_API_KEY_<USER>` / `PORKBUN_SECRET_API_KEY_<USER>` credential pair to use. Omit it to use the default `PORKBUN_API_KEY` / `PORKBUN_SECRET_API_KEY`.
152
+ Every authenticated tool accepts an optional `user` parameter that selects which entry from `PORKBUN_ACCOUNTS` to use. Omit it to use the default account.
135
153
 
136
154
  ## Development
137
155
 
package/dist/client.d.ts CHANGED
@@ -1,11 +1,12 @@
1
1
  /**
2
- * Discover all configured users by scanning environment variables.
2
+ * Returns the list of configured user identifiers, lowercased.
3
3
  *
4
- * Returns an array of user identifiers (lowercased) that have a complete
5
- * `PORKBUN_API_KEY_<USER>` + `PORKBUN_SECRET_API_KEY_<USER>` pair. The
6
- * default (unsuffixed) `PORKBUN_API_KEY` is reported as `"default"` when set.
4
+ * Includes "default" when default credentials are present, plus any users
5
+ * defined via the PORKBUN_ACCOUNTS JSON array.
7
6
  */
8
7
  export declare function listConfiguredUsers(): string[];
8
+ /** Test-only: clear the parsed-accounts cache. */
9
+ export declare function _resetAccountsCache(): void;
9
10
  export declare function porkbunRequest<T>(path: string, body?: Record<string, unknown>, user?: string): Promise<T>;
10
11
  export declare function porkbunRequestNoAuth<T>(path: string, body?: Record<string, unknown>): Promise<T>;
11
12
  //# sourceMappingURL=client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAiB9C;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAkBZ"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAgIA;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAkBZ"}
package/dist/client.js CHANGED
@@ -1,61 +1,129 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.listConfiguredUsers = listConfiguredUsers;
4
+ exports._resetAccountsCache = _resetAccountsCache;
4
5
  exports.porkbunRequest = porkbunRequest;
5
6
  exports.porkbunRequestNoAuth = porkbunRequestNoAuth;
6
7
  const BASE_URL = "https://api.porkbun.com/api/json/v3";
7
- function envName(prefix, user) {
8
- if (!user)
9
- return prefix;
10
- // Normalize user identifier: uppercase, replace any non-alphanumeric with `_`
11
- const suffix = user.toUpperCase().replace(/[^A-Z0-9]/g, "_");
12
- return `${prefix}_${suffix}`;
13
- }
14
- function getApiKey(user) {
15
- const name = envName("PORKBUN_API_KEY", user);
16
- const key = process.env[name];
17
- if (!key)
18
- throw new Error(`${name} environment variable is not set`);
19
- return key;
20
- }
21
- function getSecretApiKey(user) {
22
- const name = envName("PORKBUN_SECRET_API_KEY", user);
23
- const key = process.env[name];
24
- if (!key)
25
- throw new Error(`${name} environment variable is not set`);
26
- return key;
8
+ let cachedAccounts = null;
9
+ let cachedSnapshot;
10
+ function envSnapshot() {
11
+ // Used to detect env changes between calls (mainly in tests). Hashing the
12
+ // raw values is fine because env vars are short.
13
+ const parts = [];
14
+ for (const k of Object.keys(process.env).sort()) {
15
+ if (k === "PORKBUN_ACCOUNTS" || k.startsWith("PORKBUN_API_KEY") || k.startsWith("PORKBUN_SECRET_API_KEY")) {
16
+ parts.push(`${k}=${process.env[k] ?? ""}`);
17
+ }
18
+ }
19
+ return parts.join("\n");
27
20
  }
28
21
  /**
29
- * Discover all configured users by scanning environment variables.
22
+ * Build the account map from all supported configuration sources, merged in
23
+ * this order (later sources override earlier ones for the same user):
24
+ *
25
+ * 1. Top-level PORKBUN_API_KEY / PORKBUN_SECRET_API_KEY → "default" account
26
+ * 2. Suffixed PORKBUN_API_KEY_<USER> / PORKBUN_SECRET_API_KEY_<USER>
27
+ * 3. PORKBUN_ACCOUNTS JSON array (highest priority)
30
28
  *
31
- * Returns an array of user identifiers (lowercased) that have a complete
32
- * `PORKBUN_API_KEY_<USER>` + `PORKBUN_SECRET_API_KEY_<USER>` pair. The
33
- * default (unsuffixed) `PORKBUN_API_KEY` is reported as `"default"` when set.
29
+ * User identifiers are lowercased throughout.
34
30
  */
35
- function listConfiguredUsers() {
36
- const users = [];
31
+ function parseAccounts() {
32
+ const snapshot = envSnapshot();
33
+ if (cachedAccounts && cachedSnapshot === snapshot)
34
+ return cachedAccounts;
35
+ const map = new Map();
36
+ // 1. Default account from top-level env vars
37
37
  if (process.env.PORKBUN_API_KEY && process.env.PORKBUN_SECRET_API_KEY) {
38
- users.push("default");
38
+ map.set("default", {
39
+ user: "default",
40
+ apiKey: process.env.PORKBUN_API_KEY,
41
+ secretApiKey: process.env.PORKBUN_SECRET_API_KEY,
42
+ });
39
43
  }
40
- const seen = new Set();
44
+ // 2. Suffixed env-var pairs: PORKBUN_API_KEY_<USER> / PORKBUN_SECRET_API_KEY_<USER>
41
45
  for (const envKey of Object.keys(process.env)) {
42
46
  const m = envKey.match(/^PORKBUN_API_KEY_(.+)$/);
43
47
  if (!m)
44
48
  continue;
45
49
  const suffix = m[1];
46
- const secretName = `PORKBUN_SECRET_API_KEY_${suffix}`;
47
- if (process.env[envKey] && process.env[secretName] && !seen.has(suffix)) {
48
- seen.add(suffix);
49
- users.push(suffix.toLowerCase());
50
+ const apiKey = process.env[envKey];
51
+ const secretApiKey = process.env[`PORKBUN_SECRET_API_KEY_${suffix}`];
52
+ if (!apiKey || !secretApiKey)
53
+ continue;
54
+ const user = suffix.toLowerCase();
55
+ map.set(user, { user, apiKey, secretApiKey });
56
+ }
57
+ // 3. PORKBUN_ACCOUNTS JSON array (overrides anything above)
58
+ const raw = process.env.PORKBUN_ACCOUNTS;
59
+ if (raw && raw.trim()) {
60
+ let parsed;
61
+ try {
62
+ parsed = JSON.parse(raw);
63
+ }
64
+ catch (err) {
65
+ throw new Error(`PORKBUN_ACCOUNTS is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
66
+ }
67
+ if (!Array.isArray(parsed)) {
68
+ throw new Error("PORKBUN_ACCOUNTS must be a JSON array of account objects");
69
+ }
70
+ const seen = new Set();
71
+ for (const [i, entry] of parsed.entries()) {
72
+ if (!entry || typeof entry !== "object") {
73
+ throw new Error(`PORKBUN_ACCOUNTS[${i}] is not an object`);
74
+ }
75
+ const acc = entry;
76
+ const apiKey = acc.PORKBUN_API_KEY ?? acc.apiKey;
77
+ const secretApiKey = acc.PORKBUN_SECRET_API_KEY ?? acc.secretApiKey;
78
+ if (!apiKey || !secretApiKey) {
79
+ throw new Error(`PORKBUN_ACCOUNTS[${i}] is missing PORKBUN_API_KEY or PORKBUN_SECRET_API_KEY`);
80
+ }
81
+ const user = (acc.user ?? "default").trim().toLowerCase();
82
+ if (seen.has(user)) {
83
+ throw new Error(`PORKBUN_ACCOUNTS contains duplicate user "${user}"`);
84
+ }
85
+ seen.add(user);
86
+ map.set(user, { user, apiKey, secretApiKey });
50
87
  }
51
88
  }
52
- return users;
89
+ cachedAccounts = map;
90
+ cachedSnapshot = snapshot;
91
+ return map;
92
+ }
93
+ function resolveAccount(user) {
94
+ const accounts = parseAccounts();
95
+ const key = (user ?? "default").trim().toLowerCase();
96
+ const acc = accounts.get(key);
97
+ if (!acc) {
98
+ if (!user || key === "default") {
99
+ throw new Error("No default Porkbun credentials configured. Set PORKBUN_API_KEY and " +
100
+ "PORKBUN_SECRET_API_KEY (or supply a default entry via PORKBUN_ACCOUNTS).");
101
+ }
102
+ const known = [...accounts.keys()].join(", ") || "(none)";
103
+ throw new Error(`No Porkbun credentials configured for user "${user}". Configured users: ${known}`);
104
+ }
105
+ return acc;
106
+ }
107
+ /**
108
+ * Returns the list of configured user identifiers, lowercased.
109
+ *
110
+ * Includes "default" when default credentials are present, plus any users
111
+ * defined via the PORKBUN_ACCOUNTS JSON array.
112
+ */
113
+ function listConfiguredUsers() {
114
+ return [...parseAccounts().keys()];
115
+ }
116
+ /** Test-only: clear the parsed-accounts cache. */
117
+ function _resetAccountsCache() {
118
+ cachedAccounts = null;
119
+ cachedSnapshot = undefined;
53
120
  }
54
121
  async function porkbunRequest(path, body, user) {
122
+ const account = resolveAccount(user);
55
123
  const url = `${BASE_URL}${path}`;
56
124
  const payload = {
57
- apikey: getApiKey(user),
58
- secretapikey: getSecretApiKey(user),
125
+ apikey: account.apiKey,
126
+ secretapikey: account.secretApiKey,
59
127
  ...body,
60
128
  };
61
129
  const res = await fetch(url, {
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -13,7 +13,7 @@ const email_js_1 = require("./tools/email.js");
13
13
  const marketplace_js_1 = require("./tools/marketplace.js");
14
14
  const server = new mcp_js_1.McpServer({
15
15
  name: "porkbun-mcp",
16
- version: "1.1.0",
16
+ version: "1.3.0",
17
17
  });
18
18
  const allTools = [
19
19
  ...utility_js_1.utilityTools,
@@ -1,9 +1,15 @@
1
1
  import { z } from "zod";
2
2
  /**
3
3
  * Optional `user` field added to every authenticated tool. Selects which
4
- * Porkbun credential pair to use (`PORKBUN_API_KEY_<USER>` /
5
- * `PORKBUN_SECRET_API_KEY_<USER>`, uppercased). Omit to use the default
6
- * `PORKBUN_API_KEY` / `PORKBUN_SECRET_API_KEY`.
4
+ * Porkbun account credentials to use.
5
+ *
6
+ * User identifiers can be configured via any of:
7
+ * • Suffixed env vars `PORKBUN_API_KEY_<USER>` / `PORKBUN_SECRET_API_KEY_<USER>`
8
+ * • A `PORKBUN_ACCOUNTS` JSON array of `{user, PORKBUN_API_KEY, PORKBUN_SECRET_API_KEY}`
9
+ *
10
+ * Omit `user` to use the default account
11
+ * (`PORKBUN_API_KEY` / `PORKBUN_SECRET_API_KEY`, or the `PORKBUN_ACCOUNTS`
12
+ * entry with `user: "default"`).
7
13
  */
8
14
  export declare const userField: z.ZodOptional<z.ZodString>;
9
15
  //# sourceMappingURL=_shared.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,SAAS,4BAQnB,CAAC"}
1
+ {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,4BAQnB,CAAC"}
@@ -4,15 +4,21 @@ exports.userField = void 0;
4
4
  const zod_1 = require("zod");
5
5
  /**
6
6
  * Optional `user` field added to every authenticated tool. Selects which
7
- * Porkbun credential pair to use (`PORKBUN_API_KEY_<USER>` /
8
- * `PORKBUN_SECRET_API_KEY_<USER>`, uppercased). Omit to use the default
9
- * `PORKBUN_API_KEY` / `PORKBUN_SECRET_API_KEY`.
7
+ * Porkbun account credentials to use.
8
+ *
9
+ * User identifiers can be configured via any of:
10
+ * • Suffixed env vars `PORKBUN_API_KEY_<USER>` / `PORKBUN_SECRET_API_KEY_<USER>`
11
+ * • A `PORKBUN_ACCOUNTS` JSON array of `{user, PORKBUN_API_KEY, PORKBUN_SECRET_API_KEY}`
12
+ *
13
+ * Omit `user` to use the default account
14
+ * (`PORKBUN_API_KEY` / `PORKBUN_SECRET_API_KEY`, or the `PORKBUN_ACCOUNTS`
15
+ * entry with `user: "default"`).
10
16
  */
11
17
  exports.userField = zod_1.z
12
18
  .string()
13
19
  .optional()
14
- .describe("Optional user identifier to select which Porkbun account credentials to use. " +
15
- "Resolves env vars PORKBUN_API_KEY_<USER> and PORKBUN_SECRET_API_KEY_<USER> " +
16
- "(user is uppercased, non-alphanumerics become underscores). Omit to use the " +
17
- "default PORKBUN_API_KEY / PORKBUN_SECRET_API_KEY.");
20
+ .describe("Optional user identifier to select which Porkbun account credentials to " +
21
+ "use. Configure users via suffixed env vars (PORKBUN_API_KEY_<USER> / " +
22
+ "PORKBUN_SECRET_API_KEY_<USER>) or a PORKBUN_ACCOUNTS JSON array. " +
23
+ "Matching is case-insensitive. Omit to use the default account.");
18
24
  //# sourceMappingURL=_shared.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;GAKG;AACU,QAAA,SAAS,GAAG,OAAC;KACvB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,+EAA+E;IAC7E,6EAA6E;IAC7E,8EAA8E;IAC9E,mDAAmD,CACtD,CAAC"}
1
+ {"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;;;;;;GAWG;AACU,QAAA,SAAS,GAAG,OAAC;KACvB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,0EAA0E;IACxE,uEAAuE;IACvE,mEAAmE;IACnE,gEAAgE,CACnE,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "porkbun-mcp-server",
3
- "version": "1.1.0",
3
+ "version": "1.3.0",
4
4
  "description": "MCP server for Porkbun API v3 — domain registration, DNS management, SSL certificates, and more",
5
5
  "main": "dist/index.js",
6
6
  "bin": {