@proof-holdings/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Proof of Holdings
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,345 @@
+# @proof-holdings/mcp-server
+
+MCP (Model Context Protocol) server for the [proof.holdings](https://proof.holdings) API. Exposes 118 tools for AI agents to create verifications, validate proofs, manage assets, and more.
+
+## Installation
+
+```bash
+npm install -g @proof-holdings/mcp-server
+```
+
+Or run directly with npx (no install needed):
+
+```bash
+npx @proof-holdings/mcp-server
+```
+
+Or run with Docker:
+
+```bash
+docker run -i --rm -e PROOF_API_KEY=pk_live_xxx ghcr.io/proofholdings/mcp-server
+```
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `PROOF_API_KEY` | Yes | — | API key (`pk_live_...` or `pk_test_...`) |
+| `PROOF_BASE_URL` | No | `https://api.proof.holdings` | API base URL |
+
+Get your API key from the [proof.holdings dashboard](https://proof.holdings/dashboard/api-keys).
+
+## Client Setup
+
+Add the following to your MCP client config file:
+
+```json
+{
+  "mcpServers": {
+    "proof-holdings": {
+      "command": "npx",
+      "args": ["-y", "@proof-holdings/mcp-server"],
+      "env": {
+        "PROOF_API_KEY": "pk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Config file location by client:
+
+| Client | Config file |
+|---|---|
+| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Cursor | `.cursor/mcp.json` in your project root |
+| Claude Code | Run `claude mcp add proof-holdings -- npx -y @proof-holdings/mcp-server` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "proof-holdings": {
+      "command": "npx",
+      "args": ["-y", "@proof-holdings/mcp-server"],
+      "env": {
+        "PROOF_API_KEY": "pk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Docker
+
+Use Docker if you prefer not to install Node.js:
+
+```json
+{
+  "mcpServers": {
+    "proof-holdings": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "-e", "PROOF_API_KEY=pk_live_your_key_here",
+        "ghcr.io/proofholdings/mcp-server"
+      ]
+    }
+  }
+}
+```
+
+If installed globally (`npm install -g @proof-holdings/mcp-server`), use `"command": "proof-mcp"` and remove the `"args"` field.
+
+## Tools (118)
+
+### Verifications (12)
+
+| Tool | Description |
+|---|---|
+| `create_verification` | Create a new verification |
+| `get_verification` | Get a verification by ID |
+| `list_verifications` | List verifications with optional filters |
+| `trigger_verification` | Trigger a DNS/HTTP verification check |
+| `submit_verification_code` | Submit an OTP/challenge code |
+| `resend_verification` | Resend a verification (email channel) |
+| `test_verify` | Auto-complete a verification (test mode only) |
+| `list_verified_users` | List verified users grouped by external user ID |
+| `get_verified_user` | Get a verified user's verifications |
+| `start_domain_verification` | Start a B2B domain verification |
+| `check_domain_verification` | Check a pending domain verification |
+| `wait_for_verification` | Poll until verification reaches terminal state |
+
+### Verification Requests (6)
+
+| Tool | Description |
+|---|---|
+| `create_verification_request` | Create a multi-asset verification request |
+| `get_verification_request` | Get a verification request by ID |
+| `list_verification_requests` | List verification requests |
+| `get_request_by_reference` | Get a verification request by reference ID |
+| `cancel_verification_request` | Cancel a pending verification request |
+| `wait_for_request` | Poll until request reaches terminal state |
+
+### Proofs (4)
+
+| Tool | Description |
+|---|---|
+| `validate_proof` | Validate a proof token (checks revocation) |
+| `get_proof_status` | Get proof status by verification ID |
+| `revoke_proof` | Revoke a proof by verification ID |
+| `list_revoked_proofs` | Get the revocation list |
+
+### Sessions (3)
+
+| Tool | Description |
+|---|---|
+| `create_session` | Create a phone verification session |
+| `get_session` | Get session status by ID |
+| `wait_for_session` | Poll until session reaches terminal state |
+
+### Assets (3)
+
+| Tool | Description |
+|---|---|
+| `list_assets` | List verified assets |
+| `get_asset` | Get an asset by ID |
+| `revoke_asset` | Revoke a verified asset |
+
+### Auth (3)
+
+| Tool | Description |
+|---|---|
+| `get_current_user` | Get the current authenticated user |
+| `list_auth_sessions` | List active auth sessions |
+| `revoke_auth_session` | Revoke an auth session |
+
+### Settings (4)
+
+| Tool | Description |
+|---|---|
+| `get_usage` | Get API usage stats |
+| `get_settings` | Get account settings |
+| `update_settings` | Update account settings |
+| `export_data` | Export account data |
+
+### Templates (7)
+
+| Tool | Description |
+|---|---|
+| `list_templates` | List message templates |
+| `get_default_templates` | Get default templates |
+| `get_template` | Get a template by channel and type |
+| `update_template` | Update a template |
+| `delete_template` | Delete a custom template |
+| `preview_template` | Preview a rendered template |
+| `render_template` | Render a template with variables |
+
+### Webhook Deliveries (4)
+
+| Tool | Description |
+|---|---|
+| `get_webhook_stats` | Get webhook delivery stats |
+| `list_webhook_deliveries` | List webhook deliveries |
+| `get_webhook_delivery` | Get a webhook delivery by ID |
+| `retry_webhook_delivery` | Retry a failed webhook delivery |
+
+### Billing (1)
+
+| Tool | Description |
+|---|---|
+| `get_subscription` | Get subscription details |
+
+### Projects (9)
+
+| Tool | Description |
+|---|---|
+| `list_projects` | List projects |
+| `create_project` | Create a project |
+| `get_project` | Get a project by ID |
+| `update_project` | Update a project |
+| `delete_project` | Delete a project |
+| `list_project_templates` | List project templates |
+| `update_project_template` | Update a project template |
+| `delete_project_template` | Delete a project template |
+| `preview_project_template` | Preview a project template |
+
+### Profiles (10)
+
+| Tool | Description |
+|---|---|
+| `list_profiles` | List profiles |
+| `create_profile` | Create a profile |
+| `get_profile` | Get a profile by ID |
+| `update_profile` | Update a profile |
+| `delete_profile` | Delete a profile |
+| `set_primary_profile` | Set a profile as primary |
+| `update_profile_proofs` | Update profile proofs |
+| `get_my_profile` | Get your public profile |
+| `update_my_profile` | Update your public profile |
+| `get_profile_assets` | Get profile assets |
+
+### Emails (7)
+
+| Tool | Description |
+|---|---|
+| `list_emails` | List email addresses |
+| `remove_email` | Remove an email address |
+| `set_primary_email` | Set an email as primary |
+| `start_add_email` | Start adding a new email |
+| `get_add_email_status` | Get email addition status |
+| `verify_email_otp` | Verify email OTP code |
+| `resend_email_otp` | Resend email OTP code |
+
+### Phones (5)
+
+| Tool | Description |
+|---|---|
+| `list_phones` | List phone numbers |
+| `remove_phone` | Remove a phone number |
+| `set_primary_phone` | Set a phone as primary |
+| `start_add_phone` | Start adding a new phone |
+| `get_add_phone_status` | Get phone addition status |
+
+### API Keys (4)
+
+| Tool | Description |
+|---|---|
+| `list_api_keys` | List API keys |
+| `create_api_key` | Create an API key (2FA required) |
+| `revoke_api_key` | Revoke an API key (2FA required) |
+| `regenerate_api_key` | Regenerate an API key (2FA required) |
+
+### 2FA (4)
+
+| Tool | Description |
+|---|---|
+| `start_2fa` | Start a 2FA challenge |
+| `get_2fa_status` | Get 2FA session status |
+| `verify_2fa` | Verify a 2FA code |
+| `verify_2fa_magic_link` | Verify via 2FA magic link |
+
+### Domains (17)
+
+| Tool | Description |
+|---|---|
+| `list_domains` | List domains |
+| `add_domain` | Add a domain |
+| `get_domain` | Get a domain by ID |
+| `delete_domain` | Delete a domain |
+| `verify_domain` | Verify a domain (DNS check) |
+| `connect_cloudflare` | Connect domain via Cloudflare |
+| `connect_godaddy` | Connect domain via GoDaddy |
+| `connect_dns_provider` | Connect domain via DNS provider |
+| `add_verification_provider` | Add a verification provider to a domain |
+| `get_dns_providers` | Get available DNS providers |
+| `verify_domain_with_credentials` | Verify domain with stored credentials |
+| `check_domain_credentials` | Check domain credential status |
+| `start_domain_email_verification` | Start domain email verification |
+| `confirm_domain_email_code` | Confirm domain email verification code |
+| `resend_domain_email` | Resend domain verification email |
+| `setup_domain_email` | Set up domain email forwarding |
+| `check_domain_email_status` | Check domain email setup status |
+
+### DNS Credentials (3)
+
+| Tool | Description |
+|---|---|
+| `list_dns_credentials` | List stored DNS credentials |
+| `create_dns_credential` | Store DNS provider credentials |
+| `delete_dns_credential` | Delete stored DNS credentials |
+
+### User Requests (7)
+
+| Tool | Description |
+|---|---|
+| `list_my_requests` | List your verification requests |
+| `list_incoming_requests` | List incoming verification requests |
+| `create_user_request` | Create a verification request |
+| `claim_request_assets` | Claim assets from a completed request |
+| `cancel_user_request` | Cancel a verification request |
+| `extend_request` | Extend a request expiration |
+| `share_request_email` | Share a request via email |
+
+### User Domain Verify (3)
+
+| Tool | Description |
+|---|---|
+| `start_user_domain_verification` | Start a user domain verification |
+| `get_user_domain_verification_status` | Get domain verification status |
+| `check_user_domain_verification` | Check domain verification result |
+
+### Public Profiles (2)
+
+| Tool | Description |
+|---|---|
+| `claim_username` | Claim a public profile username |
+| `update_public_proofs` | Update public proof display |
+
+## Test Mode
+
+Use a test-mode API key (`pk_test_*`) to interact with the API without creating real verifications. Test-mode keys are available in your [dashboard](https://proof.holdings/dashboard/api-keys).
+
+## Transport
+
+Stdio only. The server communicates over stdin/stdout using the MCP protocol.
+
+## Requirements
+
+- Node.js >= 18.0.0
+- A proof.holdings API key
+
+## Links
+
+- [proof.holdings](https://proof.holdings) — Product website
+- [API Documentation](https://proof.holdings/docs/api) — REST API reference
+- [Dashboard](https://proof.holdings/dashboard) — Manage your account and API keys
+
+## License
+
+[MIT](LICENSE)

package/dist/http.d.ts

@@ -0,0 +1,34 @@
+export interface HttpClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+type QueryValue = string | number | boolean | undefined;
+export declare class HttpClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly maxRetries;
+    constructor(config: HttpClientConfig);
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        query?: Record<string, QueryValue>;
+    }): Promise<T>;
+    get<T>(path: string, query?: Record<string, QueryValue>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    del<T>(path: string): Promise<T>;
+    private buildUrl;
+    private backoff;
+    private sleep;
+}
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, statusCode: number, details?: unknown | undefined);
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAExD,qBAAa,UAAU;IACrB,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,gBAAgB;IAO9B,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACpC,GACA,OAAO,CAAC,CAAC,CAAC;IA2Eb,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;CAGd;AAED,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,OAAO;gBAHjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,YAAA;CAMpC"}

package/dist/http.js

@@ -0,0 +1,117 @@
+const VERSION = '1.0.0';
+export class HttpClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    maxRetries;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.timeout = config.timeout ?? 30_000;
+        this.maxRetries = config.maxRetries ?? 2;
+    }
+    async request(method, path, options) {
+        const url = this.buildUrl(path, options?.query);
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const response = await fetch(url, {
+                    method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${this.apiKey}`,
+                        'User-Agent': `proof-mcp/${VERSION}`,
+                    },
+                    body: options?.body ? JSON.stringify(options.body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (response.status === 429 && attempt < this.maxRetries) {
+                    const retryAfter = response.headers.get('Retry-After');
+                    const parsed = retryAfter ? parseInt(retryAfter, 10) : NaN;
+                    const delay = Number.isFinite(parsed) && parsed > 0 ? Math.min(parsed * 1000, 60_000) : this.backoff(attempt);
+                    await this.sleep(delay);
+                    continue;
+                }
+                if (response.status >= 500 && attempt < this.maxRetries) {
+                    await this.sleep(this.backoff(attempt));
+                    continue;
+                }
+                const body = (await response.json().catch(() => ({})));
+                if (!response.ok) {
+                    const apiError = body.error;
+                    const code = apiError?.code ?? `http_${response.status}`;
+                    const message = apiError?.message ?? `Request failed with status ${response.status}`;
+                    throw new ApiError(message, code, response.status, apiError?.details);
+                }
+                return body;
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                if (error instanceof ApiError)
+                    throw error;
+                lastError = error;
+                if (lastError.name === 'AbortError') {
+                    if (attempt < this.maxRetries) {
+                        await this.sleep(this.backoff(attempt));
+                        continue;
+                    }
+                    throw new ApiError(`Request to ${method} ${path} timed out after ${this.timeout}ms`, 'timeout', 0);
+                }
+                if (attempt < this.maxRetries) {
+                    await this.sleep(this.backoff(attempt));
+                    continue;
+                }
+            }
+        }
+        throw new ApiError(lastError?.message ?? 'Network request failed', 'network_error', 0);
+    }
+    get(path, query) {
+        return this.request('GET', path, { query });
+    }
+    post(path, body) {
+        return this.request('POST', path, { body });
+    }
+    put(path, body) {
+        return this.request('PUT', path, { body });
+    }
+    patch(path, body) {
+        return this.request('PATCH', path, { body });
+    }
+    del(path) {
+        return this.request('DELETE', path);
+    }
+    buildUrl(path, query) {
+        const url = new URL(path, this.baseUrl);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    backoff(attempt) {
+        return Math.min(1000 * Math.pow(2, attempt), 10000);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+export class ApiError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'ApiError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { HttpClient } from './http.js';
+import { registerTools as registerVerifications } from './tools/verifications.js';
+import { registerTools as registerVerificationRequests } from './tools/verification-requests.js';
+import { registerTools as registerProofs } from './tools/proofs.js';
+import { registerTools as registerSessions } from './tools/sessions.js';
+import { registerTools as registerAssets } from './tools/assets.js';
+import { registerTools as registerAuth } from './tools/auth.js';
+import { registerTools as registerSettings } from './tools/settings.js';
+import { registerTools as registerTemplates } from './tools/templates.js';
+import { registerTools as registerWebhookDeliveries } from './tools/webhook-deliveries.js';
+import { registerTools as registerBilling } from './tools/billing.js';
+import { registerTools as registerProjects } from './tools/projects.js';
+import { registerTools as registerProfiles } from './tools/profiles.js';
+import { registerTools as registerEmails } from './tools/emails.js';
+import { registerTools as registerPhones } from './tools/phones.js';
+import { registerTools as registerApiKeys } from './tools/api-keys.js';
+import { registerTools as registerTwofa } from './tools/twofa.js';
+import { registerTools as registerDomains } from './tools/domains.js';
+import { registerTools as registerDnsCredentials } from './tools/dns-credentials.js';
+import { registerTools as registerUserRequests } from './tools/user-requests.js';
+import { registerTools as registerUserDomainVerify } from './tools/user-domain-verify.js';
+import { registerTools as registerPublicProfiles } from './tools/public-profiles.js';
+const API_KEY = process.env.PROOF_API_KEY;
+const BASE_URL = process.env.PROOF_BASE_URL ?? 'https://api.proof.holdings';
+if (!API_KEY) {
+    console.error('Error: PROOF_API_KEY environment variable is required.');
+    console.error('Set it in your MCP client config or export it before running.');
+    process.exit(1);
+}
+const http = new HttpClient({
+    apiKey: API_KEY,
+    baseUrl: BASE_URL,
+});
+const server = new McpServer({
+    name: 'proof-holdings',
+    version: '1.0.0',
+});
+// Register all tool modules
+const tool = server.tool.bind(server);
+registerVerifications(tool, http);
+registerVerificationRequests(tool, http);
+registerProofs(tool, http);
+registerSessions(tool, http);
+registerAssets(tool, http);
+registerAuth(tool, http);
+registerSettings(tool, http);
+registerTemplates(tool, http);
+registerWebhookDeliveries(tool, http);
+registerBilling(tool, http);
+registerProjects(tool, http);
+registerProfiles(tool, http);
+registerEmails(tool, http);
+registerPhones(tool, http);
+registerApiKeys(tool, http);
+registerTwofa(tool, http);
+registerDomains(tool, http);
+registerDnsCredentials(tool, http);
+registerUserRequests(tool, http);
+registerUserDomainVerify(tool, http);
+registerPublicProfiles(tool, http);
+// Catch unhandled errors to avoid silent crashes
+process.on('uncaughtException', (err) => {
+    console.error('Uncaught exception:', err.message);
+    process.exit(1);
+});
+process.on('unhandledRejection', (err) => {
+    console.error('Unhandled rejection:', err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+// Connect via stdio
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/api-keys.d.ts

@@ -0,0 +1,4 @@
+import type { HttpClient } from '../http.js';
+import type { ToolRegistrar } from '../types.js';
+export declare function registerTools(tool: ToolRegistrar, http: HttpClient): void;
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/tools/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../../src/tools/api-keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,QAoElE"}