Skip to content

Apply documentation edit pass - #1244

Open
stephenvapiai wants to merge 3 commits into
mainfrom
codex/documentation-edit-pass
Open

stephenvapiai wants to merge 3 commits into
mainfrom
codex/documentation-edit-pass

Conversation

@stephenvapiai

@stephenvapiai stephenvapiai commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Standardize Function tool response terminology
  • Clarify MCP and API Request tool recommendations
  • Update the legacy Make route to point to the new integration guide
  • Improve the Function tool request JSON example
  • Standardize example domains and phone numbers

Scope

This follow-up applies a focused documentation edit pass after #1243.

It intentionally leaves the Make page title and structure, the MCP client navigation label, fern/tools/mcp.mdx, and generated API schemas unchanged.

Validation

  • Parsed all 3 JSON examples in fern/tools/custom-tools.mdx
  • Parsed all 4 JSON examples in fern/tools/static-variables-and-aliases/static-parameters.mdx
  • Confirmed example values use a reserved example.com domain and +1 415 555-01xx phone numbers
  • Confirmed /tools/make redirects to the existing /tools/integrations/make route
  • Confirmed the MCP client navigation label remains unchanged
  • Ran git diff --check
  • Scanned the changed pages for hidden work material
  • Did not run local Fern checks

@lightsage-app

lightsage-app Bot commented Sep 22, 2026

Copy link
Copy Markdown

Lightsage docs evals

Result: completed with failures
Staging docs: https://vapi-preview-01a0ca02-87a9-706c-ac5a-44c06f4a3fcb.docs.buildwithfern.com
Commit: a49f0df

Average score: 67/100
Passed: 2/3
Failed: 1

Eval ID Status Score Model Tools Docs 404
08e24c18-82a0-45de-abdc-d237bd12bc0f Pass 100 claude-code/global.anthropic.claude... 14 1
08e24c18-82a0-45de-abdc-d237bd12bc0f Fail 0 cursor/auto 0 0
08e24c18-82a0-45de-abdc-d237bd12bc0f Pass 100 codex/gpt-5.4 29 0

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

## 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.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added some clarity bc this block is talking about the make mcp not vapi mcp

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants