@primate-intelligence/mcp 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# @primate-intelligence/mcp
+
+MCP (Model Context Protocol) server for the [Primate Vision API](https://primateintelligence.ai/docs) by Primate Intelligence. Gives AI agents video scene understanding as tools: register a video, ask a question, get a deterministic answer with confidence and clip timestamps.
+
+> **Status:** built in-repo. Not yet published to npm — run from the repo (`node mcp/dist/index.js`) until the first public release. A hosted SSE endpoint is planned.
+
+## Setup
+
+```jsonc
+// claude_desktop_config.json / .mcp.json / mcp.json
+{
+  "mcpServers": {
+    "primate-intelligence": {
+      "command": "npx",
+      "args": ["@primate-intelligence/mcp"],
+      "env": { "PRIMATE_API_KEY": "pv_live_…" }
+    }
+  }
+}
+```
+
+Get a free test key with no signup:
+
+```bash
+curl -X POST https://api.primateintelligence.ai/v1/sandbox
+```
+
+**Security contract:** the API key is read from the `PRIMATE_API_KEY` environment variable **only**. No tool accepts a key argument — keys never appear in agent transcripts (enforced by a unit test).
+
+## Tools (v1.0)
+
+| Tool | Does |
+|---|---|
+| `create_video_from_url` | Register a video from a public https URL (`POST /v1/videos`) |
+| `create_analysis` | Ask a question about a video (`POST /v1/analyses`) |
+| `get_analysis` | Fetch analysis status/result (`GET /v1/analyses/{id}`) |
+| `wait_for_analysis` | Poll until terminal state, return the final analysis |
+| `list_models` | List available models (`GET /v1/models`) |
+| `get_usage` | Credit balance + period meters (`GET /v1/usage`) |
+| `get_test_fixture` | Stable fixture for integration self-verification (`GET /v1/test-fixture`) |
+
+Tool descriptions and schemas mirror the OpenAPI document at `GET /v1/openapi.json` — the spec is the source of truth.
+
+## Typical agent flow
+
+1. `get_test_fixture` → verify the integration works (test keys return deterministic results)
+2. `create_video_from_url` with the customer's video URL
+3. `create_analysis` with a question ("Is there a person in this video?")
+4. `wait_for_analysis` → `result.answer` (`yes` | `no` | `indeterminate`) + `result.confidence` + `result.clips`
+5. On `insufficient_credits`: `get_usage`, report the balance, point the human at billing
+
+## Env
+
+| Var | Required | Default |
+|---|---|---|
+| `PRIMATE_API_KEY` | yes | — |
+| `PRIMATE_BASE_URL` | no | `https://api.primateintelligence.ai` |

package/dist/api.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Minimal API client for the MCP server.
+ *
+ * SECURITY (design §5.3 / §18.1): the API key is read from the
+ * PRIMATE_API_KEY environment variable ONLY. It is never accepted as a
+ * tool argument — that would land secret keys in agent transcripts.
+ */
+export declare const BASE_URL: string;
+export declare function apiKey(): string;
+export interface ApiErrorBody {
+    code: string;
+    message: string;
+    docs_url?: string;
+    request_id?: string;
+    param?: string | null;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: ApiErrorBody;
+    constructor(status: number, body: ApiErrorBody);
+}
+export declare function api<T>(method: 'GET' | 'POST' | 'DELETE', path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;

package/dist/api.js

@@ -0,0 +1,49 @@
+/**
+ * Minimal API client for the MCP server.
+ *
+ * SECURITY (design §5.3 / §18.1): the API key is read from the
+ * PRIMATE_API_KEY environment variable ONLY. It is never accepted as a
+ * tool argument — that would land secret keys in agent transcripts.
+ */
+export const BASE_URL = (process.env.PRIMATE_BASE_URL ?? 'https://api.primateintelligence.ai').replace(/\/$/, '');
+export function apiKey() {
+    const key = process.env.PRIMATE_API_KEY;
+    if (!key) {
+        throw new Error('PRIMATE_API_KEY is not set. Set it in the MCP server environment (never pass keys as tool arguments). ' +
+            'Get a free test key: curl -X POST https://api.primateintelligence.ai/v1/sandbox');
+    }
+    return key;
+}
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`${body.code}: ${body.message}`);
+        this.status = status;
+        this.body = body;
+    }
+}
+export async function api(method, path, body, headers = {}) {
+    const res = await fetch(BASE_URL + path, {
+        method,
+        headers: {
+            Authorization: `Bearer ${apiKey()}`,
+            'User-Agent': 'primate-intelligence-mcp/0.1.0',
+            ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+            ...headers,
+        },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) {
+        let err = { code: 'internal_error', message: `HTTP ${res.status}` };
+        try {
+            err = (await res.json()).error ?? err;
+        }
+        catch {
+            /* non-JSON */
+        }
+        throw new ApiError(res.status, err);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,oCAAoC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAElH,MAAM,UAAU,MAAM;IACpB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,wGAAwG;YACtG,iFAAiF,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAUD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACZ;IAAyB;IAA9C,YAAqB,MAAc,EAAW,IAAkB;QAC9D,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QADpB,WAAM,GAAN,MAAM,CAAQ;QAAW,SAAI,GAAJ,IAAI,CAAc;IAEhE,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,MAAiC,EACjC,IAAY,EACZ,IAAc,EACd,UAAkC,EAAE;IAEpC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,GAAG,IAAI,EAAE;QACvC,MAAM;QACN,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;YACnC,YAAY,EAAE,gCAAgC;YAC9C,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,OAAO;SACX;QACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,GAAG,GAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QAClF,IAAI,CAAC;YACH,GAAG,GAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA6B,CAAC,KAAK,IAAI,GAAG,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @primate-intelligence/mcp — MCP server for the Primate Vision API.
+ *
+ *   npx @primate-intelligence/mcp        (stdio transport)
+ *
+ * Env:
+ *   PRIMATE_API_KEY   — required. Never passed as a tool argument (§5.3).
+ *   PRIMATE_BASE_URL  — optional override (default https://api.primateintelligence.ai).
+ *
+ * Docs: https://primateintelligence.ai/docs/agents
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function buildServer(): McpServer;

package/dist/index.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * @primate-intelligence/mcp — MCP server for the Primate Vision API.
+ *
+ *   npx @primate-intelligence/mcp        (stdio transport)
+ *
+ * Env:
+ *   PRIMATE_API_KEY   — required. Never passed as a tool argument (§5.3).
+ *   PRIMATE_BASE_URL  — optional override (default https://api.primateintelligence.ai).
+ *
+ * Docs: https://primateintelligence.ai/docs/agents
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { TOOLS, describeError } from './tools.js';
+export function buildServer() {
+    const server = new McpServer({
+        name: 'primate-intelligence',
+        version: '0.1.0',
+    });
+    for (const tool of TOOLS) {
+        server.tool(tool.name, tool.description, tool.schema, async (args) => {
+            try {
+                const result = await tool.handler(args);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (e) {
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: describeError(e) }],
+                };
+            }
+        });
+    }
+    return server;
+}
+async function main() {
+    // Fail fast with a helpful message when the env contract is unmet.
+    if (!process.env.PRIMATE_API_KEY) {
+        console.error('PRIMATE_API_KEY is not set. Add it to the MCP server env, e.g.\n' +
+            '  { "mcpServers": { "primate-intelligence": { "command": "npx", "args": ["@primate-intelligence/mcp"], "env": { "PRIMATE_API_KEY": "pv_…" } } } }\n' +
+            'Get a free test key: curl -X POST https://api.primateintelligence.ai/v1/sandbox');
+        process.exit(1);
+    }
+    const server = buildServer();
+    await server.connect(new StdioServerTransport());
+    console.error('primate-intelligence MCP server running (stdio)');
+}
+// Only run when executed directly (not when imported by tests).
+const invokedDirectly = process.argv[1]?.endsWith('index.js') || process.argv[1]?.endsWith('index.ts');
+if (invokedDirectly) {
+    main().catch((e) => {
+        console.error(e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;YAC5F,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAa,CAAC,CAAC;gBACjD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;iBAC5E,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7D,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,mEAAmE;IACnE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CACX,kEAAkE;YAChE,qJAAqJ;YACrJ,iFAAiF,CACpF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACnE,CAAC;AAED,gEAAgE;AAChE,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;AACvG,IAAI,eAAe,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool definitions for @primate-intelligence/mcp (design §5, PRI-438 P9).
+ *
+ * Tool descriptions and schemas mirror the OpenAPI document served at
+ * GET /v1/openapi.json — the spec is the source of truth. v1.0 scope:
+ *   create_video_from_url, create_analysis, get_analysis,
+ *   wait_for_analysis, list_models, get_usage, get_test_fixture.
+ *
+ * SECURITY: PRIMATE_API_KEY comes from the environment only — no tool
+ * accepts a key argument (§5.3: prevents keys landing in transcripts).
+ */
+import { z } from 'zod';
+export interface ToolDef<Shape extends z.ZodRawShape = z.ZodRawShape> {
+    name: string;
+    description: string;
+    schema: Shape;
+    handler: (args: z.objectOutputType<Shape, z.ZodTypeAny>) => Promise<unknown>;
+}
+/** Format API errors so agents can self-correct (code + docs_url + retryability). */
+export declare function describeError(e: unknown): string;
+export declare const TOOLS: ToolDef[];

package/dist/tools.js

@@ -0,0 +1,113 @@
+/**
+ * Tool definitions for @primate-intelligence/mcp (design §5, PRI-438 P9).
+ *
+ * Tool descriptions and schemas mirror the OpenAPI document served at
+ * GET /v1/openapi.json — the spec is the source of truth. v1.0 scope:
+ *   create_video_from_url, create_analysis, get_analysis,
+ *   wait_for_analysis, list_models, get_usage, get_test_fixture.
+ *
+ * SECURITY: PRIMATE_API_KEY comes from the environment only — no tool
+ * accepts a key argument (§5.3: prevents keys landing in transcripts).
+ */
+import { z } from 'zod';
+import { api, ApiError } from './api.js';
+/** Format API errors so agents can self-correct (code + docs_url + retryability). */
+export function describeError(e) {
+    if (e instanceof ApiError) {
+        const parts = [
+            `API error ${e.body.code} (HTTP ${e.status}): ${e.body.message}`,
+            e.body.docs_url ? `Docs: ${e.body.docs_url}` : '',
+            e.body.request_id ? `request_id: ${e.body.request_id}` : '',
+        ];
+        return parts.filter(Boolean).join('\n');
+    }
+    return e instanceof Error ? e.message : String(e);
+}
+const TERMINAL = new Set(['completed', 'failed', 'canceled']);
+export const TOOLS = [
+    {
+        name: 'create_video_from_url',
+        description: 'Register a video from a public https URL for analysis (POST /v1/videos, URL-ingest mode). ' +
+            'The API fetches the video asynchronously — the returned video starts in status "processing" and becomes "ready". ' +
+            'Supports video/mp4 and video/quicktime, max 2 GiB. Returns the video resource with its id (video_…).',
+        schema: {
+            url: z.string().url().describe('Public https URL of the video to ingest (https only, port 443).'),
+            metadata: z.record(z.string()).optional().describe('Optional key-value metadata to attach.'),
+        },
+        handler: (args) => api('POST', '/v1/videos', { url: args.url, metadata: args.metadata }),
+    },
+    {
+        name: 'create_analysis',
+        description: 'Ask a question about a video (POST /v1/analyses). Provide video_id (video_…) and a free-text prompt like ' +
+            '"Is there a person in this video?". Analysis runs asynchronously — use wait_for_analysis to block until done. ' +
+            'The result contains answer (yes|no|indeterminate), confidence (0-1), and clip timestamps.',
+        schema: {
+            video_id: z.string().describe('The video to analyze (video_… id from create_video_from_url).'),
+            prompt: z.string().max(2000).describe('Free-text question about the video, e.g. "Is there a person in this video?"'),
+            model: z.string().optional().describe('Model id (see list_models). Defaults to the current default model.'),
+            metadata: z.record(z.string()).optional().describe('Optional key-value metadata to attach.'),
+        },
+        handler: (args) => api('POST', '/v1/analyses', {
+            video_id: args.video_id,
+            prompt: args.prompt,
+            model: args.model,
+            metadata: args.metadata,
+        }),
+    },
+    {
+        name: 'get_analysis',
+        description: 'Fetch an analysis by id (GET /v1/analyses/{id}). While running, shows live progress and queue_position. ' +
+            'When status is "completed", result carries answer/confidence/clips.',
+        schema: {
+            analysis_id: z.string().describe('The analysis id (an_…).'),
+        },
+        handler: (args) => api('GET', `/v1/analyses/${args.analysis_id}`),
+    },
+    {
+        name: 'wait_for_analysis',
+        description: 'Block until an analysis reaches a terminal state (completed | failed | canceled), polling GET /v1/analyses/{id}. ' +
+            'Returns the final analysis. Default timeout 120s (test-mode analyses complete in seconds).',
+        schema: {
+            analysis_id: z.string().describe('The analysis id (an_…).'),
+            timeout_s: z.number().int().min(1).max(600).optional().describe('Max seconds to wait (default 120).'),
+        },
+        handler: async (args) => {
+            const timeoutMs = (args.timeout_s ?? 120) * 1000;
+            const deadline = Date.now() + timeoutMs;
+            let analysis = await api('GET', `/v1/analyses/${args.analysis_id}`);
+            while (!TERMINAL.has(analysis.status)) {
+                if (Date.now() > deadline) {
+                    return {
+                        ...analysis,
+                        _mcp_note: `Timed out after ${args.timeout_s ?? 120}s — analysis is still ${analysis.status}. Call wait_for_analysis again or get_analysis later.`,
+                    };
+                }
+                await new Promise((r) => setTimeout(r, 2000));
+                analysis = await api('GET', `/v1/analyses/${args.analysis_id}`);
+            }
+            return analysis;
+        },
+    },
+    {
+        name: 'list_models',
+        description: 'List available analysis models (GET /v1/models) with status (stable | preview | deprecated) and capabilities. ' +
+            'Use the model marked default:true unless you have a reason not to.',
+        schema: {},
+        handler: () => api('GET', '/v1/models'),
+    },
+    {
+        name: 'get_usage',
+        description: 'Get credit balance and period usage meters for the current API key (GET /v1/usage). ' +
+            'Use this after an insufficient_credits error to report the balance.',
+        schema: {},
+        handler: () => api('GET', '/v1/usage'),
+    },
+    {
+        name: 'get_test_fixture',
+        description: 'Get the stable test fixture (GET /v1/test-fixture): a video URL + prompt + expected answer for verifying an ' +
+            'integration end-to-end without burning quota. Test-mode (pv_test_) keys return deterministic canned results.',
+        schema: {},
+        handler: () => api('GET', '/v1/test-fixture'),
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@primate-intelligence/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Primate Vision API (Primate Intelligence) — video scene understanding tools for AI agents.",
+  "license": "MIT",
+  "author": "Primate Intelligence",
+  "homepage": "https://primateintelligence.ai/docs/agents",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Primate-Intelligence/primate-intelligence-api.git",
+    "directory": "mcp"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "video",
+    "vision",
+    "ai",
+    "primate-intelligence"
+  ],
+  "type": "module",
+  "bin": {
+    "primate-intelligence-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"const fs=require('fs');const p='dist/index.js';fs.writeFileSync(p,'#!/usr/bin/env node\\n'+fs.readFileSync(p,'utf8'));fs.chmodSync(p,0o755)\"",
+    "test": "vitest run",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}