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

Get MCP Server Usage

How often AI clients called the project's MCP server tools, and how many distinct clients called them.

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

Returns how many tool calls the project's MCP server answered in the window, how many distinct clients made them, and the calls per tool.

Note

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

Any plan. Usage stays readable after a downgrade or with the MCP Server add-on switched off.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID.

Query Parameters

NameDescription
days:integerquery
Time window in days, 1–90.
Default7

Response Fields

NameDescription
data.toolCalls:integer
Tool calls in the window, successful or not.
data.clients:integer
Distinct clients. Clients are counted without storing their IP addresses.
data.byTool:array
Calls per tool, most called first, at most 50 tools.

What is counted

Every tools/call request to the project's MCP endpoint — the doc-site endpoint at /_mcp, served by /v1/projects/{projectId}/mcp — from anonymous readers and from readers signed in to a private site alike. Listing tools is not a call, and neither is a request refused because it wasn't signed in. The account-level hosted connector at https://api.syntext.dev/mcp and the local @syntext/mcp package are not counted here.

Error Responses

400 Bad Request

days is not a whole number from 1 to 90:

json
{
"error": {
"code": "validation_error",
"message": "days must be 1–90",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

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/usage?days=7" \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
200OK
{
"data": {
"days": 7,
"toolCalls": 1284,
"clients": 37,
"byTool": [
{ "tool": "search_docs", "calls": 812 },
{ "tool": "ask_question", "calls": 301 },
{ "tool": "get_page", "calls": 171 }
]
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext