@perenia/mcp 0.1.0 → 0.2.0

package/README.md

@@ -36,7 +36,8 @@ against a dev instance).
 
 | Tool | What it does |
 |---|---|
-| `search_companies` | Text + filtered search (location, NAF activity, size, financials, financial-score grade, decision-maker age, geo radius). Compact summaries, paginated. |
+| `search_companies` | Text + filtered search (location, NAF activity, size, financials, financial-score grade, decision-maker age, geo radius). Compact summaries, paginated — or, with `columns`, rows holding exactly the requested columns (same ids as the web table's templates and CSV export). |
+| `list_columns` | The column catalogue for `search_companies` `columns`, grouped, with each column's kind and fields. No quota cost. |
 | `get_company` | Full profile by SIREN, including multi-year financial history. |
 | `get_company_officers` | Officer roster (names and roles — no personal data). |
 | `get_network_neighbours` | Companies sharing an officer network (holdings, sister companies). |

package/dist/index.js

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

package/dist/tools.js

@@ -55,20 +55,40 @@ async function guarded(fn) {
 }
 export function registerTools(server, api) {
     server.registerTool('search_companies', {
-        description: 'Search ~3.5M French companies by text query and/or filters (location, activity, size, financials, decision-maker age, financial-score grade). Returns compact summaries — use get_company for full detail. Data refreshes daily.',
+        description: 'Search ~3.5M French companies by text query and/or filters (location, activity, size, financials, decision-maker age, financial-score grade). Returns compact summaries, or — with `columns` — one row per company holding exactly the requested columns (ids from list_columns). Use get_company for full detail. Data refreshes daily.',
         inputSchema: {
             ...searchFiltersShape,
+            columns: z
+                .array(z.string())
+                .min(1)
+                .max(40)
+                .optional()
+                .describe('Ordered column ids from list_columns, e.g. ["company", "turnover", "netProfit", "founded"]. When set, results are rows keyed by column id (siren first; a code column also carries <id>_label) instead of compact summaries — pick the columns you need for a table or a comparison.'),
             page: z.number().int().min(1).max(100).optional().describe('Default 1'),
             per_page: z.number().int().min(1).max(50).optional().describe('Default 10'),
         },
     }, (args) => guarded(async () => {
-        const { page, per_page, ...filters } = args;
+        const { page, per_page, columns, ...filters } = args;
         const res = (await api.post('/v1/companies/search', {
             ...toFilterState(filters),
+            ...(columns ? { columns } : {}),
             page: page ?? 1,
             perPage: per_page ?? 10,
         }));
-        return ok({ total: res.total, page: res.page, per_page: res.per_page, companies: res.data.map(trimSummary) });
+        const paging = { total: res.total, page: res.page, per_page: res.per_page };
+        if (res.rows)
+            return ok({ ...paging, columns: res.columns, rows: res.rows });
+        return ok({ ...paging, companies: (res.data ?? []).map(trimSummary) });
+    }));
+    server.registerTool('list_columns', {
+        description: 'The column catalogue accepted by search_companies `columns`, grouped (profile, location, people, financials, score, network) with each column\'s value kind and the fields it reads. Cheap: no quota cost.',
+        inputSchema: {},
+    }, () => guarded(async () => {
+        const res = (await api.get('/v1/columns'));
+        const groups = {};
+        for (const { group, ...column } of res.columns)
+            (groups[group] ??= []).push(column);
+        return ok({ groups });
     }));
     server.registerTool('get_company', {
         description: 'Full profile of one company by SIREN: identity, location, activity descriptions, network counts, financial score, and multi-year financial history.',

package/package.json

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