/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference List MCP Server Tools

List MCP Server Tools

Every tool the project's MCP server can offer, and whether it is offered to AI clients right now.

GET/v1/projects/{projectId}/addons/mcp_server/toolsTry it
Session token

Returns every tool the project's MCP server could offer — the three built-in docs tools, then the API tools generated from your reference pages — each marked with whether MCP clients see it in tools/list right now.

Note

Session JWT and org membership required. Any role can read it — an API key gets 401, a non-member 403. Any plan.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID.

Response Fields

NameDescription
data[].name:string
The tool name MCP clients call. The built-ins are always search_docs, get_page and ask_question, listed first.
data[].description:string
The description MCP clients see.
data[].enabled:boolean
true when tools/list currently advertises the tool.

When a tool is enabled

•
The MCP Server add-on is off: every tool is enabled: false.
•
Built-in tools are enabled whenever the add-on is on, whatever the allowed tools setting.
•
Generated API tools are enabled only when all of these hold:
◦
the allowed tools setting is not docs-only
◦
the tool has an endpoint to call, and a base URL is set — in the add-on settings or, as a fallback, baseUrl in syntext.json
◦
with a custom allowlist, the tool is on it

See Generated API tools for how tools are generated.

Error Responses

401 Unauthorized

Missing, invalid or expired session JWT, or an API key.

403 Forbidden

You are not a member of the organization that owns the project.

404 Not Found

The project does not exist or has been deleted.

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/addons/mcp_server/tools \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
200OK
{
"data": [
{
"name": "search_docs",
"description": "Search the project documentation. Returns relevant pages and sections matching the query.",
"enabled": true
},
{
"name": "get_page",
"description": "Get the full content of a specific documentation page by its slug path.",
"enabled": true
},
{
"name": "ask_question",
"description": "Ask a question about the documentation and get an AI-powered answer with citations.",
"enabled": true
},
{
"name": "create_invoice",
"description": "Create an invoice",
"enabled": false
}
]
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext