pica

Instructions

Implementation Reference

• src/index.ts:123-162 (handler)

  Core handler function that fetches active user connections and available platforms from the Pica client, filters them, and returns a structured response with connections, available platforms, and summary statistics.
  async function handleGetIntegrations(args: ListPicaIntegrationsArgs) { try { const connectedIntegrations = picaClient.getUserConnections(); const availableIntegrations = picaClient.getAvailableConnectors(); const activeConnections = connectedIntegrations.filter(conn => conn.active); const activePlatforms = availableIntegrations.filter(def => def.active && !def.deprecated); const structuredResponse: ListIntegrationsResponse = { connections: activeConnections.map(conn => ({ platform: conn.platform, key: conn.key })), availablePlatforms: activePlatforms.map(def => ({ platform: def.platform, name: def.name, category: def.category })), summary: { connectedCount: activeConnections.length, availableCount: activePlatforms.length } }; return { content: [ { type: "text" as const, text: JSON.stringify(structuredResponse, null, 2), }, ], structuredContent: structuredResponse, }; } catch (error) { throw new McpError( ErrorCode.InternalError, `Failed to retrieve integrations: ${error instanceof Error ? error.message : 'Unknown error'}` ); } }
• src/index.ts:87-94 (registration)

  Registers the 'list_pica_integrations' tool with the MCP server, using the imported tool config and a thin async handler that initializes the Pica client and delegates to handleGetIntegrations.
  server.registerTool( "list_pica_integrations", listPicaIntegrationsToolConfig, async (args: z.infer<typeof listPicaIntegrationsZodSchema>) => { await initializePica(); return await handleGetIntegrations(args as ListPicaIntegrationsArgs); } );
• src/schemas.ts:89-94 (schema)

  Tool configuration object defining title, description, input schema (empty), and output schema for the list_pica_integrations tool.
  export const listPicaIntegrationsToolConfig = { title: "List Pica Integrations", description: "List all available Pica integrations and platforms. ALWAYS call this tool first in any workflow to discover what platforms and connections are available. This returns the connections that the user has and all available Pica platforms in kebab-case format (e.g., 'ship-station', 'shopify') which you'll need for subsequent tool calls.", inputSchema: listPicaIntegrationsInputSchema, outputSchema: listPicaIntegrationsOutputSchema };
• src/schemas.ts:53-67 (schema)

  Zod output schema defining the structure of the response from list_pica_integrations, including connections, available platforms, and summary.
  export const listPicaIntegrationsOutputSchema = { connections: z.array(z.object({ platform: z.string(), key: z.string() })).describe("Array of user's active connections"), availablePlatforms: z.array(z.object({ platform: z.string(), name: z.string(), category: z.string() })).describe("Array of available platforms that can be connected"), summary: z.object({ connectedCount: z.number(), availableCount: z.number() }).describe("Summary statistics of connections and available platforms") };
• src/types.ts:161-176 (helper)

  TypeScript interface defining the structured response type used by the handler for list_pica_integrations.
  export interface ListIntegrationsResponse { [x: string]: unknown; connections: Array<{ platform: string; key: string; }>; availablePlatforms: Array<{ platform: string; name: string; category: string; }>; summary: { connectedCount: number; availableCount: number; }; }