@filepad/mcp-server 0.1.0

package/dist/tool-registry.d.ts

@@ -0,0 +1,63 @@
+import type { AgentAccessScope, AgentApiSearchMode } from '@filepad/agent-access-sdk';
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    requiredScopes: AgentAccessScope[];
+}
+export interface SearchArgs {
+    query: string;
+    type?: AgentApiSearchMode | undefined;
+    limit?: number | undefined;
+}
+export interface ReadFileArgs {
+    fileNodeId: string;
+}
+export interface CreateArtifactArgs {
+    title: string;
+    text?: string | undefined;
+}
+export interface ProposeEditArgs {
+    fileNodeId: string;
+    baseVersionId: string;
+    summary: string;
+    newText: string;
+}
+export interface EmitEventArgs {
+    eventType: string;
+    payload?: Record<string, unknown> | undefined;
+}
+export interface CreateSignalArgs {
+    findingTypeKey: string;
+    summary: string;
+    severity?: 'info' | 'warn' | 'high_alert' | undefined;
+    value?: Record<string, unknown> | undefined;
+}
+export interface ListSignalsArgs {
+    findingTypeKey?: string | undefined;
+    severity?: 'info' | 'warn' | 'high_alert' | undefined;
+    status?: 'suggested' | 'accepted' | 'rejected' | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}
+export interface GetSignalArgs {
+    signalId: string;
+}
+export interface AckNotificationArgs {
+    ids: string[];
+}
+export type AgentProfileField = 'identity' | 'learnings' | 'goals' | 'timeline';
+export interface GetProfileArgs {
+    fields?: AgentProfileField[] | undefined;
+}
+export interface UpdateProfileArgs {
+    field: AgentProfileField;
+    content: string;
+    mode?: 'append' | 'replace' | undefined;
+}
+/**
+ * Return tools visible to an agent given its granted scopes.
+ */
+export declare function listToolsForScopes(scopes: AgentAccessScope[]): McpToolDefinition[];
+export declare function findTool(name: string): McpToolDefinition | undefined;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,cAAc,EAAE,gBAAgB,EAAE,CAAC;CACpC;AAID,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACtD,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,WAAW,GACX,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACzC;AAoSD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EAAE,GACzB,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEpE"}

package/dist/tool-registry.js

@@ -0,0 +1,289 @@
+// FILE MEMO: Canonical tool registry mapping Filepad Agent Access capabilities to MCP tools.
+// Filtered by scopes. Schemas are generated from Zod contracts where possible.
+const TOOL_REGISTRY = [
+    {
+        name: 'filepad_health',
+        description: 'Check that Filepad MCP can authenticate to the workspace and report granted scopes.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        requiredScopes: [],
+    },
+    {
+        name: 'filepad_search',
+        description: 'Search indexed workspace context using keyword, semantic, or hybrid retrieval. ' +
+            'Returns matching files with relevance scores and excerpts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query string' },
+                type: {
+                    type: 'string',
+                    enum: ['hybrid', 'semantic', 'keyword'],
+                    description: 'Search mode',
+                },
+                limit: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 30,
+                    description: 'Maximum results to return',
+                },
+            },
+            required: ['query'],
+        },
+        requiredScopes: ['env:read'],
+    },
+    {
+        name: 'filepad_read_file',
+        description: 'Read the content of a workspace file by its file node id. ' +
+            'Returns inline text content or unsupported for binary files.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                fileNodeId: {
+                    type: 'string',
+                    description: 'File node id (fn_...)',
+                },
+            },
+            required: ['fileNodeId'],
+        },
+        requiredScopes: ['env:read'],
+    },
+    {
+        name: 'filepad_list_tree',
+        description: 'List the workspace file tree. Returns folders and files visible to the agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        requiredScopes: ['env:read'],
+    },
+    {
+        name: 'filepad_create_artifact',
+        description: 'Create a new note artifact under the artifacts/ folder. ' +
+            'The artifact becomes a permanent workspace file.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: {
+                    type: 'string',
+                    maxLength: 500,
+                    description: 'Artifact title',
+                },
+                text: {
+                    type: 'string',
+                    description: 'Markdown content',
+                },
+            },
+            required: ['title'],
+        },
+        requiredScopes: ['artifacts:write'],
+    },
+    {
+        name: 'filepad_propose_edit',
+        description: 'Propose a reviewable edit to an existing file. ' +
+            'The edit does not apply until a human approves it. ' +
+            'Only files under artifacts/, agents/, skills/, and memory/ can be targeted.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                fileNodeId: {
+                    type: 'string',
+                    description: 'Target file node id (fn_...)',
+                },
+                baseVersionId: {
+                    type: 'string',
+                    description: 'Current version id to base the proposal on',
+                },
+                summary: {
+                    type: 'string',
+                    maxLength: 2000,
+                    description: 'Short summary of the proposed change',
+                },
+                newText: {
+                    type: 'string',
+                    description: 'Complete replacement text',
+                },
+            },
+            required: ['fileNodeId', 'baseVersionId', 'summary', 'newText'],
+        },
+        requiredScopes: ['files:propose'],
+    },
+    {
+        name: 'filepad_emit_event',
+        description: 'Emit an activity event into the workspace audit trail. ' +
+            'Use this to report completion, milestones, or errors.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                eventType: {
+                    type: 'string',
+                    maxLength: 200,
+                    description: 'Event type identifier (e.g. agent.task.completed)',
+                },
+                payload: {
+                    type: 'object',
+                    description: 'Arbitrary JSON payload',
+                },
+            },
+            required: ['eventType'],
+        },
+        requiredScopes: ['events.write'],
+    },
+    {
+        name: 'filepad_create_signal',
+        description: 'Emit a signal (finding) into the workspace context engine. ' +
+            'Signals represent observations, warnings, or alerts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                findingTypeKey: {
+                    type: 'string',
+                    maxLength: 120,
+                    description: 'Signal classification key',
+                },
+                summary: {
+                    type: 'string',
+                    maxLength: 2000,
+                    description: 'Human-readable summary',
+                },
+                severity: {
+                    type: 'string',
+                    enum: ['info', 'warn', 'high_alert'],
+                    description: 'Signal severity',
+                },
+                value: {
+                    type: 'object',
+                    description: 'Structured signal payload',
+                },
+            },
+            required: ['findingTypeKey', 'summary'],
+        },
+        requiredScopes: ['signals:write'],
+    },
+    {
+        name: 'filepad_list_signals',
+        description: 'Query workspace signals visible to this agent. ' +
+            'Signals are structured observations created by agents, Filepad, or automations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                findingTypeKey: {
+                    type: 'string',
+                    description: 'Filter by signal type key',
+                },
+                severity: {
+                    type: 'string',
+                    enum: ['info', 'warn', 'high_alert'],
+                    description: 'Minimum severity to return',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['suggested', 'accepted', 'rejected'],
+                    description: 'Filter by signal status',
+                },
+                limit: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 100,
+                    description: 'Maximum signals to return',
+                },
+                cursor: {
+                    type: 'string',
+                    description: 'Pagination cursor from a previous response',
+                },
+            },
+        },
+        requiredScopes: ['env:read'],
+    },
+    {
+        name: 'filepad_get_signal',
+        description: 'Read one workspace signal by id, including target, citations, provenance, status, and value.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                signalId: {
+                    type: 'string',
+                    description: 'Signal id',
+                },
+            },
+            required: ['signalId'],
+        },
+        requiredScopes: ['env:read'],
+    },
+    {
+        name: 'filepad_ack_notification',
+        description: 'Acknowledge one or more Filepad mailbox notifications after the agent has processed them.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 100,
+                    description: 'Mailbox notification ids to acknowledge',
+                },
+            },
+            required: ['ids'],
+        },
+        requiredScopes: ['notifications:read'],
+    },
+    {
+        name: 'filepad_get_profile',
+        description: 'Read this integration agent home profile from agents/integrations/{keyId}. ' +
+            'Returns identity, learnings, goals, and timeline profile files when present.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                fields: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['identity', 'learnings', 'goals', 'timeline'],
+                    },
+                    description: 'Optional profile fields to read',
+                },
+            },
+        },
+        requiredScopes: ['env:read'],
+    },
+    {
+        name: 'filepad_update_profile',
+        description: 'Propose a human-reviewable update to this integration agent profile. ' +
+            'Writes are proposed edits, never direct mutations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                field: {
+                    type: 'string',
+                    enum: ['identity', 'learnings', 'goals', 'timeline'],
+                    description: 'Profile field to update',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Markdown content to append or replace',
+                },
+                mode: {
+                    type: 'string',
+                    enum: ['append', 'replace'],
+                    description: 'Append a dated entry or replace the full file',
+                },
+            },
+            required: ['field', 'content'],
+        },
+        requiredScopes: ['env:read', 'files:propose'],
+    },
+];
+/**
+ * Return tools visible to an agent given its granted scopes.
+ */
+export function listToolsForScopes(scopes) {
+    const scopeSet = new Set(scopes);
+    return TOOL_REGISTRY.filter((tool) => tool.requiredScopes.every((s) => scopeSet.has(s)));
+}
+export function findTool(name) {
+    return TOOL_REGISTRY.find((t) => t.name === name);
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,12 @@
+import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+export interface StreamableHttpConfig {
+    baseUrl: string;
+    workspaceId: string;
+    keyId: string;
+    secret: string;
+}
+/**
+ * Send a JSON-RPC message to the Filepad MCP endpoint via Streamable HTTP.
+ */
+export declare function sendMcpMessage(config: StreamableHttpConfig, message: JSONRPCMessage): Promise<JSONRPCMessage[]>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AA2BD;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC,CA8B3B"}

package/dist/transport.js

@@ -0,0 +1,54 @@
+// FILE MEMO: Streamable HTTP transport for MCP over Filepad Agent Access.
+// Reuses HMAC auth at the transport boundary. No business logic.
+import { createHash, createHmac, randomUUID } from 'node:crypto';
+function signRequest(keyId, secret, method, pathWithQuery, body) {
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const nonce = randomUUID();
+    const bodyHash = createHash('sha256')
+        .update(Buffer.from(body, 'utf8'))
+        .digest('hex');
+    const canonical = [method.toUpperCase(), pathWithQuery, timestamp, nonce, bodyHash].join('\n');
+    const signature = createHmac('sha256', secret)
+        .update(canonical, 'utf8')
+        .digest('base64');
+    return {
+        'content-type': 'application/json',
+        'x-integration-key-id': keyId,
+        'x-integration-timestamp': timestamp,
+        'x-integration-nonce': nonce,
+        'x-integration-signature': signature,
+    };
+}
+/**
+ * Send a JSON-RPC message to the Filepad MCP endpoint via Streamable HTTP.
+ */
+export async function sendMcpMessage(config, message) {
+    const pathWithQuery = `/mcp/v1/workspaces/${encodeURIComponent(config.workspaceId)}/stream`;
+    const url = `${config.baseUrl.replace(/\/$/, '')}${pathWithQuery}`;
+    const body = JSON.stringify(message);
+    const headers = signRequest(config.keyId, config.secret, 'POST', pathWithQuery, body);
+    const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body,
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`MCP HTTP ${response.status}: ${text}`);
+    }
+    const responseText = await response.text();
+    if (!responseText.trim())
+        return [];
+    // Streamable HTTP can return newline-delimited JSON for multiple messages
+    const messages = [];
+    for (const line of responseText.split('\n').filter((l) => l.trim())) {
+        try {
+            messages.push(JSON.parse(line));
+        }
+        catch {
+            // Ignore non-JSON lines
+        }
+    }
+    return messages;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,iEAAiE;AAEjE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWjE,SAAS,WAAW,CAClB,KAAa,EACb,MAAc,EACd,MAAc,EACd,aAAqB,EACrB,IAAY;IAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;SAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;SACjC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/F,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC3C,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;SACzB,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpB,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,sBAAsB,EAAE,KAAK;QAC7B,yBAAyB,EAAE,SAAS;QACpC,qBAAqB,EAAE,KAAK;QAC5B,yBAAyB,EAAE,SAAS;KACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,OAAuB;IAEvB,MAAM,aAAa,GAAG,sBAAsB,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC;IAC5F,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IAEtF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,YAAY,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAEpC,0EAA0E;IAC1E,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const FILEPAD_MCP_SERVER_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const FILEPAD_MCP_SERVER_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@filepad/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Filepad Agent Access. Exposes Filepad workspaces as tools to Claude Desktop, Cursor, and other MCP clients.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "filepad-mcp-server": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "filepad",
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "author": "Filepad <support@filepad.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/filepad/filepad.git",
+    "directory": "packages/mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/filepad/filepad/issues"
+  },
+  "homepage": "https://github.com/filepad/filepad#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@filepad/agent-access-sdk": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "start": "node dist/cli.js",
+    "pack:check": "node ../../scripts/ci/check-package-pack.mjs"
+  }
+}