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 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/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 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": "..." } ```