From 27634b078f18a81888b7e6e6d861e9ec22d0fb00 Mon Sep 17 00:00:00 2001 From: Stephen Smith Date: Tue, 22 Sep 2026 09:28:22 -0700 Subject: [PATCH 1/5] apply documentation edit pass --- fern/tools/integrations/make.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/fern/tools/integrations/make.mdx b/fern/tools/integrations/make.mdx index 8749239ea..e3ef4633c 100644 --- a/fern/tools/integrations/make.mdx +++ b/fern/tools/integrations/make.mdx @@ -13,7 +13,7 @@ Connect a Vapi assistant to Make to invoke scenarios that coordinate actions and | --- | --- | --- | | An ordinary webhook that accepts and returns JSON | **[API Request tool](/tools/api-request)** | Vapi sends the configured HTTP request directly and gives the JSON response to the assistant. This is the recommended default. | | A curated tool surface that Make owns and Vapi discovers at runtime | **[MCP tool](/tools/mcp)** | Make exposes eligible scenarios as MCP tools and Vapi imports the tools exposed by that server. | -| Vapi's `tool-calls` envelope or call, assistant, and artifact context | **[Function tool](/tools/custom-tools)** | Vapi sends its webhook payload to the scenario, which must return the expected Function-tool response. | +| Vapi's `tool-calls` envelope or call, assistant, and artifact context | **[Function tool](/tools/custom-tools)** | Vapi sends its webhook payload to the scenario, which must return the expected Function tool response. | | Asynchronous execution or server-driven [Live Call Control](/calls/call-features) | **[Function tool](/tools/custom-tools)** | Function tools support asynchronous execution, and their webhook payload includes the call context needed for live control. | ## API Request @@ -24,7 +24,7 @@ This pattern has the smallest integration contract and is the best starting poin ## MCP -Use MCP when Make should define the tool surface. Make exposes active, on-demand scenarios as tools. Vapi imports every tool exposed by the configured MCP server; Vapi does not apply a separate per-tool filter. +Use an MCP tool when Make should define the tool surface. Make exposes active, on-demand scenarios as tools. Vapi imports every tool exposed by the configured MCP server; Vapi does not apply a separate per-tool filter. Configure the Make MCP token with least-privilege scopes. Use Make's [scenarios as tools access control](https://developers.make.com/mcp-server/connect-using-mcp-token/scenarios-as-tools-access-control) to expose only the scenarios the assistant needs. See [Make MCP Server](https://developers.make.com/mcp-server) for Make's current connection documentation. @@ -32,7 +32,7 @@ Configure the Make MCP token with least-privilege scopes. Use Make's [scenarios Use a Function tool when the Make scenario must receive Vapi's `tool-calls` message, including call, assistant, or artifact context. This is also the appropriate pattern for asynchronous execution or live-call actions. -The scenario must parse Vapi's webhook payload and return the [Function tool response](/tools/custom-tools#server-response-format-providing-results-and-context) for synchronous calls. This extra protocol work is unnecessary for an ordinary JSON webhook, so prefer API Request in that case. +The scenario must parse Vapi's webhook payload and return the [Function tool response](/tools/custom-tools#server-response-format-providing-results-and-context) for synchronous calls. This extra protocol work is unnecessary for an ordinary JSON webhook, so prefer an API Request tool in that case. ## Runnable examples From a139c9e13f36dbf3d251bd830973ebea327226b7 Mon Sep 17 00:00:00 2001 From: Stephen Smith Date: Tue, 22 Sep 2026 09:37:56 -0700 Subject: [PATCH 2/5] extend documentation edit pass --- fern/docs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/docs.yml b/fern/docs.yml index 8ce1835a1..3e4b6c5d2 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -1108,7 +1108,7 @@ redirects: - source: /tools/code-tool destination: /tools/api-request - source: /tools/make - destination: /tools/mcp + destination: /tools/integrations/make - source: /security-and-privacy/retrieve-call-artifacts destination: /assistants/retrieve-call-artifacts - source: /developer-documentation From a49f0dfe923f7d1eda6bd02dc21808df58388de4 Mon Sep 17 00:00:00 2001 From: Stephen Smith Date: Tue, 22 Sep 2026 09:44:16 -0700 Subject: [PATCH 3/5] complete documentation edit pass --- fern/tools/custom-tools.mdx | 26 +++++++++---------- .../static-parameters.mdx | 8 +++--- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/fern/tools/custom-tools.mdx b/fern/tools/custom-tools.mdx index 6cde4dd71..a167cb496 100644 --- a/fern/tools/custom-tools.mdx +++ b/fern/tools/custom-tools.mdx @@ -206,19 +206,19 @@ When your server receives a tool call request from Vapi, it will be in the follo } } }, - "description": "Retrieves the current weather for a specified location" - }, - "server": { - "url": "https://api.openweathermap.org/data/2.5/weather" - }, - "messages": [], - "toolCall": { - "id": "toolu_01DTPAzUm5Gk3zxrpJ969oMF", - "type": "function", - "function": { - "name": "get_weather", - "parameters": { - "location": "San Francisco" + "description": "Retrieves the current weather for a specified location", + "server": { + "url": "https://api.openweathermap.org/data/2.5/weather" + }, + "messages": [], + "toolCall": { + "id": "toolu_01DTPAzUm5Gk3zxrpJ969oMF", + "type": "function", + "function": { + "name": "get_weather", + "parameters": { + "location": "San Francisco" + } } } } diff --git a/fern/tools/static-variables-and-aliases/static-parameters.mdx b/fern/tools/static-variables-and-aliases/static-parameters.mdx index 2f617390a..2f694c50e 100644 --- a/fern/tools/static-variables-and-aliases/static-parameters.mdx +++ b/fern/tools/static-variables-and-aliases/static-parameters.mdx @@ -90,7 +90,7 @@ For Function tools, static parameters merge into the function call arguments sen } }, "server": { - "url": "https://my-server.com/webhook" + "url": "https://my-server.example.com/webhook" }, "parameters": [ { "key": "api_version", "value": "v2" }, @@ -99,7 +99,7 @@ For Function tools, static parameters merge into the function call arguments sen } ``` -When the LLM calls `lookup_user` with `{ "phone": "+15551234567" }`, your webhook receives `{ "phone": "+15551234567", "api_version": "v2", "caller_number": "+15559876543" }` -- the static parameters are merged in. +When the LLM calls `lookup_user` with `{ "phone": "+14155550100" }`, your webhook receives `{ "phone": "+14155550100", "api_version": "v2", "caller_number": "+14155550101" }` -- the static parameters are merged in. Static parameters override LLM-generated arguments with the same key. If the LLM generates `"source": "chat"` and your static parameters include `"source": "vapi-call"`, the webhook receives `"source": "vapi-call"`. @@ -151,8 +151,8 @@ Your tool server receives: { "name": "Steffen", "email": "steffen@example.com", - "caller_number": "+15551234567", - "called_number": "+18005551212", + "caller_number": "+14155550101", + "called_number": "+14155550102", "call_id": "..." } ``` From c9a55ddc0be82d46a8dbf16270972e5b15de49dc Mon Sep 17 00:00:00 2001 From: Steve Smtih Date: Wed, 23 Sep 2026 09:12:00 -0700 Subject: [PATCH 4/5] Apply suggestion from @amanda-vapi Co-authored-by: Amanda Martin <290842976+amanda-vapi@users.noreply.github.com> --- fern/tools/integrations/make.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/tools/integrations/make.mdx b/fern/tools/integrations/make.mdx index e3ef4633c..3c5b88cd3 100644 --- a/fern/tools/integrations/make.mdx +++ b/fern/tools/integrations/make.mdx @@ -24,7 +24,7 @@ This pattern has the smallest integration contract and is the best starting poin ## MCP -Use an MCP tool when Make should define the tool surface. Make exposes active, on-demand scenarios as tools. Vapi imports every tool exposed by the configured MCP server; Vapi does not apply a separate per-tool filter. +Use Make MCP when Make should define the tool surface. Make exposes active, on-demand scenarios as tools. Vapi imports every tool exposed by the configured MCP server; Vapi does not apply a separate per-tool filter. Configure the Make MCP token with least-privilege scopes. Use Make's [scenarios as tools access control](https://developers.make.com/mcp-server/connect-using-mcp-token/scenarios-as-tools-access-control) to expose only the scenarios the assistant needs. See [Make MCP Server](https://developers.make.com/mcp-server) for Make's current connection documentation. From 967fba389ed629fdfafd664be64b786705f143ec Mon Sep 17 00:00:00 2001 From: Steve Smtih Date: Thu, 24 Sep 2026 11:10:15 -0700 Subject: [PATCH 5/5] fix Function tool webhook example --- fern/tools/custom-tools.mdx | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/fern/tools/custom-tools.mdx b/fern/tools/custom-tools.mdx index a167cb496..145f88893 100644 --- a/fern/tools/custom-tools.mdx +++ b/fern/tools/custom-tools.mdx @@ -188,25 +188,30 @@ When your server receives a tool call request from Vapi, it will be in the follo "toolCallList": [ { "id": "toolu_01DTPAzUm5Gk3zxrpJ969oMF", - "name": "get_weather", - "arguments": { - "location": "San Francisco" + "type": "function", + "function": { + "name": "get_weather", + "arguments": { + "location": "San Francisco" + } } } ], "toolWithToolCallList": [ { "type": "function", - "name": "get_weather", - "parameters": { - "type": "object", - "properties": { - "location": { - "type": "string" + "function": { + "name": "get_weather", + "parameters": { + "type": "object", + "properties": { + "location": { + "type": "string" + } } - } + }, + "description": "Retrieves the current weather for a specified location" }, - "description": "Retrieves the current weather for a specified location", "server": { "url": "https://api.openweathermap.org/data/2.5/weather" }, @@ -216,7 +221,7 @@ When your server receives a tool call request from Vapi, it will be in the follo "type": "function", "function": { "name": "get_weather", - "parameters": { + "arguments": { "location": "San Francisco" } }