@perenia/mcp 0.3.0 → 0.4.0

package/README.md

@@ -41,6 +41,7 @@ against a dev instance).
 | `open_in_perenia` | Turns the same filters as `search_companies` into the URL of that search in the web app — the link to hand to a person. |
 | `list_columns` | The column catalogue for `columns`, grouped, with each column's kind and fields. No quota cost. |
 | `get_usage` | Today's quota for your key (used / limit / remaining / reset) and the per-minute rate limit. Every other tool result already ends with the same `quota` figures. |
+| `get_lists` · `get_list_contents` · `create_list` · `add_to_list` | Your lists in the Perenia app: read them (member SIRENs in display order), create one, add companies by SIREN (idempotent, unknown SIRENs reported). Need a key **bound to your Perenia user** with the `lists` scope — ask your Perenia contact; an unbound key gets `key_not_bound`. |
 
 Every result carries `perenia_url` per company (the company page in the app).
 `PERENIA_APP_URL` overrides the app origin those links use.

package/dist/index.js

@@ -11,7 +11,7 @@ if (!apiKey) {
 }
 const baseUrl = (process.env.PERENIA_API_URL ?? 'https://api.perenia.ai').replace(/\/$/, '');
 const appUrl = (process.env.PERENIA_APP_URL ?? 'https://app.perenia.ai').replace(/\/$/, '');
-const server = new McpServer({ name: 'perenia', version: '0.3.0' });
+const server = new McpServer({ name: 'perenia', version: '0.4.0' });
 registerTools(server, new ApiClient({ baseUrl, apiKey }), { appUrl });
 await server.connect(new StdioServerTransport());
 console.error(`perenia-mcp ready (${baseUrl})`);

package/dist/tools.js

@@ -153,6 +153,28 @@ export function registerTools(server, api, opts) {
             (groups[group] ??= []).push(column);
         return ok({ groups });
     }));
+    // ---- Lists: the user's own objects. Need a key bound to a Perenia user
+    // (the API answers 403 key_not_bound otherwise) and the `lists` scope.
+    const listIdParam = z.string().uuid().describe('List id, from get_lists');
+    server.registerTool('get_lists', {
+        description: "The user's lists in the Perenia app (default list first) with member counts. Needs an API key bound to a Perenia user; otherwise the error says key_not_bound.",
+        inputSchema: {},
+    }, () => guarded(async () => {
+        const res = (await api.get('/v1/lists'));
+        return ok({ lists: res.data });
+    }));
+    server.registerTool('get_list_contents', {
+        description: 'One list with its member SIRENs in display order. Pass them to get_companies (100 at a time) for the data, or to search_companies as exclude_list_ids to dedupe against the list.',
+        inputSchema: { list_id: listIdParam },
+    }, ({ list_id }) => guarded(async () => ok((await api.get(`/v1/lists/${list_id}`)))));
+    server.registerTool('create_list', {
+        description: 'Create an empty list in the Perenia app for the user (name 1–100 characters). Returns the list with its id.',
+        inputSchema: { name: z.string().min(1).max(100) },
+    }, ({ name }) => guarded(async () => ok((await api.post('/v1/lists', { name })))));
+    server.registerTool('add_to_list', {
+        description: 'Add companies to a list by SIREN (1–10,000 per call, idempotent). Returns which SIRENs were added, which were already in the list, and which Perenia does not know.',
+        inputSchema: { list_id: listIdParam, sirens: z.array(sirenParam).min(1).max(10_000) },
+    }, ({ list_id, sirens }) => guarded(async () => ok((await api.post(`/v1/lists/${list_id}/companies`, { sirens })))));
     server.registerTool('open_in_perenia', {
         description: 'Hand a search to a person: the same filters as search_companies become the URL of that search in the Perenia web app (live results, facets, export, lists). Returns the link — give it to the user. A geographic radius (lat/lng) has no URL form and is dropped.',
         inputSchema: { ...searchFiltersShape },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perenia/mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "MCP server for the Perenia Partner API — search and analyze French companies from any MCP client",
   "type": "module",
   "license": "UNLICENSED",