@convertcom/mcp-server 0.0.1-beta.12 → 0.0.1-beta.13

package/.assets/convert-icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Convert">
+  <rect width="64" height="64" rx="14" fill="#24292F"/>
+  <path fill="#FFFFFF" d="M22.3 44.6c-4.8 0-8.5-1.6-11.2-4.7-2.7-3-4-7.3-4-12.9 0-5.4 1.3-9.6 3.9-12.6 2.7-3.1 6.4-4.7 11.2-4.7 5 0 8.9 1.5 11.7 4.5 1.5 1.9 2.6 4 3.3 6.4h-8.8c-.4-.8-.8-1.5-1.3-1.9-1.1-1.2-2.6-1.8-4.7-1.8-1.8 0-3.4.6-4.5 1.8-1.5 1.7-2.3 4.5-2.3 8.3 0 3.9.8 6.6 2.3 8.2 1.1 1.3 2.7 2 4.9 2 1.4 0 2.6-.3 3.6-.9.3-.1.5-.2.7-.4.2-.2.4-.4.7-.7.2-.3.5-.6 1-1 .5-.4 1.3-.6 2.3-.6h6.3c-.9 3.5-2.7 6.2-5.3 8.1-2.6 1.9-5.9 2.9-9.8 2.9Z"/>
+  <path fill="#FFFFFF" opacity=".56" d="m39.4 13.6-2 4.8 4.1 9.3L46 16.1l-6.6-2.5Z"/>
+  <path fill="#FFFFFF" opacity=".78" d="m50.8 12.7-7.3 19.3 4.1 9.4L57.8 15.4l-7-2.7Z"/>
+  <path fill="#FFFFFF" d="m57.8 15.4-2.1-12.3-9.8 7.5 2.7 1.1-13 33.7h7.5l12.1-31 2.6 1Z"/>
+</svg>

package/README.md

@@ -20,7 +20,7 @@ MCP (Model Context Protocol) is an open standard that allows AI models to intera
 **Key Benefits:**
 - 🔌 **Zero-config integration** – Works with Claude Desktop, Cursor, and any MCP-compatible client
 - 🔍 **Full API access** – Comprehensive coverage of Convert's [REST API v2](https://api.convert.com/doc/v2.0.0/)
-- 📚 **Built-in knowledge** – 5,776 indexed chunks across 500 Convert support article URLs
+- 📚 **Built-in knowledge** – 5,797 indexed chunks across 500 Convert support article URLs
 - 🛡️ **Configurable permissions** – Three access levels from reporting-only to full read/write
 - 🧩 **Namespaced tools** – Clean interface with 13 generated API namespaces plus one computed `operator` namespace
 - 🧠 **MCP prompts** – 19 curated Convert experimentation prompts exposed through `prompts/list` and `prompts/get`
@@ -55,6 +55,16 @@ MCP (Model Context Protocol) is an open standard that allows AI models to intera
 
 The server implements the [Model Context Protocol](https://modelcontextprotocol.io) and works with Claude Desktop, Cursor, and any MCP-compatible client.
 
+### Hosted Remote MCP
+
+If your MCP client supports remote connectors, you can connect to Convert without managing local API keys:
+
+```text
+https://mcp.ai.app.convert.com/mcp
+```
+
+Your client will open Convert for sign-in and permission approval. The local `npx` setup below remains the default for stdio-based clients and existing installations.
+
 ### Recommended Models
 
 For the best experience, use models with strong agentic capabilities:

package/build/auth-context.d.ts

@@ -17,9 +17,34 @@ export type NoAuthContext = {
     type: 'none';
 };
 export type ConvertAuthContext = HmacAuthContext | BearerTokenAuthContext | SecretKeyAuthContext | NoAuthContext;
+export type ConvertApiTransportRequest = {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    data?: unknown;
+};
+export type ConvertApiTransportResponse = {
+    status: number;
+    headers: Record<string, string>;
+    data?: unknown;
+};
+export type ConvertApiTransport = (request: ConvertApiTransportRequest) => Promise<ConvertApiTransportResponse>;
+export type AuthorizedProjectGrant = {
+    project_id: number;
+    name?: string;
+    role?: string;
+};
+export type AuthorizedAccountGrant = {
+    account_id: number;
+    name?: string;
+    projects?: AuthorizedProjectGrant[];
+};
 export type ToolExecutionContext = {
     authContext?: ConvertAuthContext;
     credentialsByAccount?: Map<number, ConvertAuthContext>;
+    apiBaseUrl?: string;
+    apiTransport?: ConvertApiTransport;
+    authorizedAccounts?: AuthorizedAccountGrant[];
     principalId?: string;
     missingCredentialsHint?: string;
 };

package/build/brand.d.ts

@@ -0,0 +1,6 @@
+import type { Icon } from '@modelcontextprotocol/sdk/types.js';
+export declare const CONVERT_WEBSITE_URL = "https://www.convert.com/";
+export declare const DEFAULT_ICON_BASE_URL = "https://mcp.ai.app.convert.com";
+export declare function normalizeIconBaseUrl(baseUrl: string | undefined): string;
+export declare function convertBrandIcons(baseUrl?: string): Icon[];
+export declare function brandAssetPath(pathname: string): string | null;

package/build/brand.js

@@ -0,0 +1,89 @@
+export const CONVERT_WEBSITE_URL = 'https://www.convert.com/';
+export const DEFAULT_ICON_BASE_URL = 'https://mcp.ai.app.convert.com';
+export function normalizeIconBaseUrl(baseUrl) {
+    const normalized = (baseUrl || DEFAULT_ICON_BASE_URL).trim().replace(/\/+$/, '');
+    return normalized || DEFAULT_ICON_BASE_URL;
+}
+export function convertBrandIcons(baseUrl) {
+    const base = normalizeIconBaseUrl(baseUrl);
+    return [
+        {
+            src: `${base}/convert-logo.png`,
+            mimeType: 'image/png',
+            sizes: ['567x122'],
+        },
+        {
+            src: `${base}/icon-512.png`,
+            mimeType: 'image/png',
+            sizes: ['512x512'],
+        },
+        {
+            src: `${base}/icon.png`,
+            mimeType: 'image/png',
+            sizes: ['512x512'],
+        },
+        {
+            src: `${base}/icon-256.png`,
+            mimeType: 'image/png',
+            sizes: ['256x256'],
+        },
+        {
+            src: `${base}/icon-192.png`,
+            mimeType: 'image/png',
+            sizes: ['192x192'],
+        },
+        {
+            src: `${base}/icon-128.png`,
+            mimeType: 'image/png',
+            sizes: ['128x128'],
+        },
+        {
+            src: `${base}/favicon.png`,
+            mimeType: 'image/png',
+            sizes: ['64x64'],
+        },
+        {
+            src: `${base}/favicon.ico`,
+            mimeType: 'image/x-icon',
+            sizes: ['16x16', '32x32', '48x48'],
+        },
+        {
+            src: `${base}/logo-light.svg`,
+            mimeType: 'image/svg+xml',
+            sizes: ['any'],
+            theme: 'light',
+        },
+        {
+            src: `${base}/logo-dark.svg`,
+            mimeType: 'image/svg+xml',
+            sizes: ['any'],
+            theme: 'dark',
+        },
+        {
+            src: `${base}/convert-icon.svg`,
+            mimeType: 'image/svg+xml',
+            sizes: ['any'],
+        },
+    ];
+}
+export function brandAssetPath(pathname) {
+    if (pathname === '/favicon.ico' ||
+        pathname === '/favicon.png' ||
+        pathname === '/apple-touch-icon.png' ||
+        pathname === '/convert-logo.png' ||
+        pathname === '/icon.png' ||
+        pathname === '/icon-192.png' ||
+        pathname === '/icon-256.png' ||
+        pathname === '/icon-512.png' ||
+        pathname === '/icon-128.png' ||
+        pathname === '/icon-180.png' ||
+        pathname === '/og-image.png' ||
+        pathname === '/convert-icon-64.png' ||
+        pathname === '/convert-icon.svg' ||
+        pathname === '/logo-light.svg' ||
+        pathname === '/logo-dark.svg') {
+        return pathname;
+    }
+    return null;
+}
+//# sourceMappingURL=brand.js.map

package/build/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAEtE,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,UAAU,IAAI,qBAAqB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO;QACL;YACE,GAAG,EAAE,GAAG,IAAI,mBAAmB;YAC/B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,eAAe;YAC3B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,WAAW;YACvB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,eAAe;YAC3B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,eAAe;YAC3B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,eAAe;YAC3B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,cAAc;YAC1B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,OAAO,CAAC;SACjB;QACD;YACE,GAAG,EAAE,GAAG,IAAI,cAAc;YAC1B,QAAQ,EAAE,cAAc;YACxB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;SACnC;QACD;YACE,GAAG,EAAE,GAAG,IAAI,iBAAiB;YAC7B,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,CAAC,KAAK,CAAC;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,GAAG,EAAE,GAAG,IAAI,gBAAgB;YAC5B,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,CAAC,KAAK,CAAC;YACd,KAAK,EAAE,MAAM;SACd;QACD;YACE,GAAG,EAAE,GAAG,IAAI,mBAAmB;YAC/B,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,CAAC,KAAK,CAAC;SACf;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IACE,QAAQ,KAAK,cAAc;QAC3B,QAAQ,KAAK,cAAc;QAC3B,QAAQ,KAAK,uBAAuB;QACpC,QAAQ,KAAK,mBAAmB;QAChC,QAAQ,KAAK,WAAW;QACxB,QAAQ,KAAK,eAAe;QAC5B,QAAQ,KAAK,eAAe;QAC5B,QAAQ,KAAK,eAAe;QAC5B,QAAQ,KAAK,eAAe;QAC5B,QAAQ,KAAK,eAAe;QAC5B,QAAQ,KAAK,eAAe;QAC5B,QAAQ,KAAK,sBAAsB;QACnC,QAAQ,KAAK,mBAAmB;QAChC,QAAQ,KAAK,iBAAiB;QAC9B,QAAQ,KAAK,gBAAgB,EAC7B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}