> ## Documentation Index > Fetch the complete documentation index at: https://highseat.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # MCP tool calls > Calls AI assistants made to the site's own MCP server, recorded by `highseat/mcp`: totals, calls by assistant and calls by tool, with error counts, latency and empty results. Takes no filter: a call carries no page, place, device or source. Calls per bucket come from the timeseries with `event` set to `mcp_tool_call`. ## OpenAPI ````yaml https://api.highseat.com/v1/openapi.json get /sites/{site}/tool-calls openapi: 3.1.1 info: title: Highseat Stats API version: 1.0.0 description: >- The same figures the dashboard shows, and the changes an admin makes there. A read key answers every GET route; a write key also answers the routes that change data. Authentication, write keys, idempotency, limits and the shape of every response: https://highseat.com/docs/api. license: name: Proprietary servers: - url: https://api.highseat.com/v1 security: - bearerAuth: [] paths: /sites/{site}/tool-calls: get: tags: - Stats summary: MCP tool calls description: >- Calls AI assistants made to the site's own MCP server, recorded by `highseat/mcp`: totals, calls by assistant and calls by tool, with error counts, latency and empty results. Takes no filter: a call carries no page, place, device or source. Calls per bucket come from the timeseries with `event` set to `mcp_tool_call`. operationId: getToolCalls parameters: - name: site in: path required: true schema: type: string description: 'The site: its domain as registered (example.com), or its site id.' - name: period in: query schema: anyOf: - enum: - day - week - month - year - all - custom type: string - type: string pattern: ^([1-9]\d{0,3})(mo|m|h|d|w)$ default: 7d description: >- The range: a calendar unit (day, week, month, year) positioned by `date`; a window ending now as a count and unit, m h d w mo (30m, 24h, 7d, 2w, 3mo); all; or custom, which reads `from` and `to`. Defaults to 7d. allowEmptyValue: true allowReserved: true - name: date in: query schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Which day/week/month/year a unit preset refers to, YYYY-MM-DD in the site's timezone. Omitted means the current one. allowEmptyValue: true allowReserved: true - name: from in: query schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: First day of a custom range, YYYY-MM-DD, inclusive. allowEmptyValue: true allowReserved: true - name: to in: query schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: Last day of a custom range, YYYY-MM-DD, inclusive. allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: totals: type: object properties: calls: type: integer minimum: 0 maximum: 9007199254740991 description: Calls AI assistants made to the site's MCP server. errors: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls that ended in an error code rather than `ok`. error_rate: type: number description: >- Percent, 0 to 100. Calls that were errors, to one decimal. p50_ms: anyOf: - type: number - type: 'null' description: >- Milliseconds. Median call duration; null when no call reported one. p95_ms: anyOf: - type: number - type: 'null' description: >- Milliseconds. 95th-percentile call duration; null when no call reported one. listed: type: integer minimum: 0 maximum: 9007199254740991 description: Calls to a read-only tool that returned a list. empty: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls whose list was empty: the assistant found nothing. empty_rate: type: number description: >- Percent, 0 to 100. Listed calls whose list was empty, to one decimal. required: - calls - errors - error_rate - p50_ms - p95_ms - listed - empty - empty_rate assistants: type: array items: type: object properties: name: type: string description: >- The assistant (Claude, ChatGPT, Cursor, …), Scripts for an HTTP library, or the client's name as sent. calls: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls AI assistants made to the site's MCP server. errors: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls that ended in an error code rather than `ok`. error_rate: type: number description: >- Percent, 0 to 100. Calls that were errors, to one decimal. p95_ms: anyOf: - type: number - type: 'null' description: >- Milliseconds. 95th-percentile call duration; null when no call reported one. declared: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls whose client named itself in the MCP handshake. from_user_agent: type: integer minimum: 0 maximum: 9007199254740991 description: Calls whose client was read off its User-Agent. unnamed: type: integer minimum: 0 maximum: 9007199254740991 description: Calls whose client nothing named. required: - name - calls - errors - error_rate - p95_ms - declared - from_user_agent - unnamed description: Calls by assistant, most first, up to 100. tools: type: array items: type: object properties: name: type: string description: The tool's name. calls: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls AI assistants made to the site's MCP server. errors: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls that ended in an error code rather than `ok`. error_rate: type: number description: >- Percent, 0 to 100. Calls that were errors, to one decimal. p95_ms: anyOf: - type: number - type: 'null' description: >- Milliseconds. 95th-percentile call duration; null when no call reported one. listed: type: integer minimum: 0 maximum: 9007199254740991 description: Calls to a read-only tool that returned a list. empty: type: integer minimum: 0 maximum: 9007199254740991 description: >- Calls whose list was empty: the assistant found nothing. empty_rate: type: number description: >- Percent, 0 to 100. Listed calls whose list was empty, to one decimal. required: - name - calls - errors - error_rate - p95_ms - listed - empty - empty_rate description: Calls by tool, most first, up to 100. required: - totals - assistants - tools meta: type: object properties: timezone: type: string description: >- The site's timezone, which every day boundary falls in. currency: type: string description: ISO 4217 code of every amount in the response. range: anyOf: - type: object properties: from: type: string description: ISO 8601, inclusive. to: type: string description: ISO 8601, exclusive. required: - from - to - type: 'null' description: The instants the period resolved to. compare: anyOf: - type: object properties: from: type: string description: ISO 8601, inclusive. to: type: string description: ISO 8601, exclusive. required: - from - to - type: 'null' description: The comparison range, when one was asked for. required: - timezone - currency - range - compare required: - data - meta headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' '400': $ref: '#/components/responses/Error400' '401': $ref: '#/components/responses/Error401' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '422': $ref: '#/components/responses/Error422' '429': $ref: '#/components/responses/Error429' '503': $ref: '#/components/responses/Error503' components: headers: RateLimit-Limit: description: Calls the key may make in the window. schema: type: integer RateLimit-Remaining: description: Calls left in the current window. schema: type: integer RateLimit-Reset: description: Seconds until the window reopens. schema: type: integer RateLimit-Policy: description: >- The quota and window, as the IETF draft writes it: "hourly";q=600;w=3600. schema: type: string RateLimit: description: >- The remaining budget, as the IETF draft writes it: "hourly";r=599;t=3540. schema: type: string Retry-After: description: Seconds to wait before the next call. schema: type: integer responses: Error400: description: 'The request is malformed: BAD_REQUEST, INVALID_FILTER or INVALID_CURSOR.' headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' content: application/json: schema: $ref: '#/components/schemas/Error' Error401: description: 'No API key, or one that is not valid: UNAUTHORIZED.' headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' content: application/json: schema: $ref: '#/components/schemas/Error' Error403: description: 'The workspace''s reports are closed until it pays: FORBIDDEN.' headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' content: application/json: schema: $ref: '#/components/schemas/Error' Error404: description: 'The site, the row the path names or the route does not exist: NOT_FOUND.' headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' content: application/json: schema: $ref: '#/components/schemas/Error' Error422: description: 'The report ran into the time cap; try a shorter range: QUERY_TIMEOUT.' headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' content: application/json: schema: $ref: '#/components/schemas/Error' Error429: description: >- The key has used its hourly budget (RATE_LIMITED), or its workspace already runs as many calls at once as it may (TOO_MANY_CONCURRENT_REQUESTS). headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Error' Error503: description: 'The server is busy; retry in a moment: SERVICE_UNAVAILABLE.' headers: RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' RateLimit: $ref: '#/components/headers/RateLimit' content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object properties: error: type: object properties: code: type: string description: >- Stable and machine-readable: BAD_REQUEST, INVALID_FILTER, INVALID_CURSOR, UNAUTHORIZED, FORBIDDEN, KEY_READ_ONLY, NOT_FOUND, METHOD_NOT_ALLOWED, CONFLICT, IDEMPOTENCY_KEY_IN_USE, PAYLOAD_TOO_LARGE, IDEMPOTENCY_KEY_REUSED, QUERY_TIMEOUT, RATE_LIMITED, TOO_MANY_CONCURRENT_REQUESTS, SERVICE_UNAVAILABLE or INTERNAL_SERVER_ERROR. A write may answer a code of its own: a conflict (GOAL_EXISTS, DOMAIN_TAKEN) or a limit (GOAL_LIMIT_REACHED, FUNNEL_LIMIT_REACHED, SHARE_LINK_LIMIT_REACHED). Codes are added, never renamed. message: type: string description: What went wrong, written for a person. id: type: string description: >- On a conflict, the existing row's id, so a client can update it instead. issues: type: array items: type: object properties: path: type: array items: anyOf: - type: string - type: number description: >- The parameter at fault, e.g. ['filter', 1] for the second filter. message: type: string required: - path - message description: One entry per invalid parameter. required: - code - message required: - error securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.