@withone/mcp 2.1.0 → 2.2.0

package/README.md

@@ -66,7 +66,7 @@ The server exposes three MCP tools:
 
 ### Finding actions
 
-`find_one_actions` takes one `requests` entry per operation, each a kebab-case `platform` and a short `intent` naming the operation alone (`"send a message to a channel"`, not the message). An optional `task` describes the whole job in general terms, which helps choose between similar actions. For each intent, One's decision model picks the action to use; the answer documents it, sets apart a substitute when the model was unsure, and lists a few alternatives. Large documents come back as a digest; call `find_one_actions` again with `load: [{ action_id, section }]` for a section it left out, `full: true` for the whole document, or `toc: true` for its table of contents. `ONE_ACTION_IDS`, `ONE_PERMISSIONS` and `ONE_CONNECTION_KEYS` apply to every answer: an action they refuse is never offered, and when they refuse the model's pick, the next allowed candidate takes its place.
+`find_one_actions` takes one `requests` entry per operation, each a kebab-case `platform` and a short `intent` naming the operation alone (`"send a message to a channel"`, not the message). A `task` describes the whole job in general terms, and an `ai_model` names the model asking; agents are asked to send both with every find, since the task helps tell similar actions apart. For each intent, One's decision model picks the action to use; the answer documents it, sets apart a substitute when the model was unsure, and lists a few alternatives. A `platform` no active platform has (`clickup` for `click-up`) is not searched: the answer names the platforms it may have meant, closest first, so the agent can ask again with the right one. Large documents come back as a digest; call `find_one_actions` again with `load: [{ action_id, section }]` for a section it left out, `full: true` for the whole document, or `toc: true` for its table of contents. `ONE_ACTION_IDS`, `ONE_PERMISSIONS` and `ONE_CONNECTION_KEYS` apply to every answer: an action they refuse is never offered, and when they refuse the model's pick, the next allowed candidate takes its place.
 
 Upgrading from 1.x: `search_one_platform_actions` and `get_one_action_knowledge` are removed. `find_one_actions` replaces both.
 

package/build/find.js

@@ -93,6 +93,13 @@ function status(answer, narrowed) {
     if (narrowed.replaced) {
         return 'The chosen action is not allowed on this server, so this is the next allowed candidate: check it fits before using it.';
     }
+    if (answer.selector === 'unknown_platform') {
+        const opening = `No active platform is named \`${answer.platform}\`.`;
+        const suggestions = answer.suggestions ?? [];
+        return suggestions.length === 0
+            ? `${opening} Check the platform name: \`list_one_integrations\` gives the exact name of each connected integration.`
+            : `${opening} Did you mean ${suggestions.map((s) => `\`${s}\``).join(', ')}? Ask again with the platform you meant.`;
+    }
     if (answer.selector === 'none_fit' || answer.selected.length === 0) {
         return answer.alternatives.length === 0
             ? 'No action fits this intent, and nothing close was found. Rephrase it, or check the platform name.'

package/build/find.test.js

@@ -131,6 +131,18 @@ describe('find_one_actions', () => {
         assert.ok(text.includes('No action fits this intent, and nothing close was found.'));
         assert.ok(!text.includes(FIND_EXECUTE_HINT));
     });
+    it('names the platforms core suggests for a name no active platform has', async () => {
+        const unknown = (suggestions) => answer({ platform: 'clickup', intent: 'create a task', selected: [], alternatives: [], selector: 'unknown_platform', confidence: undefined, suggestions });
+        const asked = [
+            { platform: 'clickup', intent: 'create a task' },
+            { platform: 'clickup', intent: 'create a task' },
+        ];
+        const text = await findOneActions({ requests: asked }, deps([unknown(['click-up', 'click-house']), unknown()]), settings());
+        assert.ok(text.includes('No active platform is named `clickup`. Did you mean `click-up`, `click-house`? Ask again with the platform you meant.'), text);
+        assert.ok(text.includes('Check the platform name: `list_one_integrations` gives the exact name'), text);
+        assert.ok(!text.includes('No action fits'), 'an unknown platform is not read as a platform with no fitting action');
+        assert.ok(!text.includes(FIND_EXECUTE_HINT), 'nothing was documented');
+    });
     it('loads what each entry asked for, refusing one this server may not use in the words for a missing one', async () => {
         const text = await findOneActions({ load: [{ action_id: 'a', section: 'Response Fields' }, { action_id: 'missing' }, { action_id: 'b' }] }, deps([], { a: LARGE }), settings({ actionIds: ['a', 'missing'] }));
         assert.ok(text.includes('### Action a'));

package/build/schemas.js

@@ -21,14 +21,14 @@ export const findOneActionsInputSchema = {
         platform: z.string().describe('The kebab-case platform identifier (e.g. "gmail", "stripe").'),
         intent: z.string().describe('The operation alone, in a few words (e.g. "send a message to a channel"), without its data: no IDs, names or message text.')
     })).min(1).max(10).optional().describe('What to do, one entry per API operation, on any platforms (1 to 10). Each is the kebab-case platform (e.g. "gmail", "hubspot") and a short intent (e.g. "send an email", "find a contact by email").'),
-    task: z.string().optional().describe('The whole task in one line, in general terms (e.g. "email a report to a contact"): what it does, without names, addresses, IDs or message text. It helps choose between similar actions. Never the chat history. Only with `requests`.'),
+    task: z.string().optional().describe('The whole task in one line, in general terms (e.g. "email a report to a contact"): what it does, without names, addresses, IDs or message text. Send it with every find: it helps tell similar actions apart. Never the chat history. Only with `requests`.'),
     load: z.array(z.object({
         action_id: z.string().describe("The actionId from a find_one_actions answer."),
         section: z.string().optional().describe('Section name(s) to load, comma-separated (e.g. "Response Fields"). Omit, with `full` and `toc` unset, for the digest. In knowledge mode every load returns the whole document, so `section` and `toc` do not narrow it.'),
         full: z.boolean().optional().describe("Load the whole document. Ignored when `section` is set."),
         toc: z.boolean().optional().describe("Load only the table of contents. Ignored when `section` is set.")
     })).min(1).max(10).optional().describe("More documentation for actions already found (1 to 10): a section the digest omitted, the whole document, the table of contents, or an alternative's documentation. Use instead of `requests`."),
-    ai_model: z.string().optional().describe('The AI model you are running as (e.g. "claude-sonnet-5", "gpt-5"), recorded with this find so the account\'s usage can report which model asked. Optional.')
+    ai_model: z.string().optional().describe('Your model name as you know it (e.g. "claude-sonnet-5", "gpt-5"), recorded with this find. Send it with every find; leave it out only if you do not know which model you are.')
 };
 /**
  * Schema for executing One actions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withone/mcp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A Model Context Protocol Server for One",
   "type": "module",
   "bin": {