Skip to main content
Glama
Browse API reference
POST/v1/telemetry/usage

Report tool usage

Send MCP tool usage data to the server.

No authentication required
IMPORTANT

Displaying MCP Directory API data requires visible Glama credit.Review attribution & licensing.

Request body

clientstringrequired

Client identifier, such as the client repository or website URL.

serverstringrequired

MCP server namespace and slug.

pattern ^[^/]+\/[^/]+$
toolstringrequired

Tool name.

Responses

200Success
{
  "success": true
}
successbooleanrequired
400Invalid request
{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request"
  }
}
errorobjectrequired
Show fields
codeErrorCoderequired

Error code

idstring / uuid
pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
messagestringrequired
403Access forbidden
{
  "error": {
    "code": "forbidden",
    "message": "Access forbidden",
    "param": null,
    "type": "forbidden"
  }
}
errorobjectrequired
Show fields
codeRateLimitErrorCoderequired
messagestringrequired
paramnullrequired
nullable
typeRateLimitErrorCoderequired
404Not found
{
  "error": {
    "code": "not_found",
    "message": "Not found"
  }
}
errorobjectrequired
Show fields
codeErrorCoderequired

Error code

idstring / uuid
pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
messagestringrequired
429Rate limit exceeded
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded",
    "param": null,
    "type": "rate_limit_exceeded"
  }
}
errorobjectrequired
Show fields
codeRateLimitErrorCoderequired
messagestringrequired
paramnullrequired
nullable
typeRateLimitErrorCoderequired
500Internal server error
{
  "error": {
    "code": "internal_server_error",
    "message": "Internal server error"
  }
}
errorobjectrequired
Show fields
codeErrorCoderequired

Error code

idstring / uuid
pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
messagestringrequired