For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://modelgates.ai/docs/_mcp/server.

Analytics - Go SDK

The Go SDK and docs are currently in beta. Report issues on GitHub.

Overview

Analytics and usage endpoints

Available Operations

GetUserActivity

Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Management key required.

Example Usage

go
package main import(	"context"	"os"	modelgates "github.com/ModelGatesTeam/go-sdk"	"log") func main() {    ctx := context.Background()     s := modelgates.New(        modelgates.WithSecurity(os.Getenv("MODELGATES_API_KEY")),    )     res, err := s.Analytics.GetUserActivity(ctx, nil, nil, nil)    if err != nil {        log.Fatal(err)    }    if res != nil {        // handle response    }}

Parameters

ParameterTypeRequiredDescriptionExample
ctxcontext.Context:heavy_check_mark:The context to use for the request.
date*string:heavy_minus_sign:Filter by a single UTC date in the last 30 days (YYYY-MM-DD format).2025-08-24
apiKeyHash*string:heavy_minus_sign:Filter by API key hash (SHA-256 hex string, as returned by the keys API).abc123def456...
userID*string:heavy_minus_sign:Filter by org member user ID. Only applicable for organization accounts.user_abc123
opts[]operations.Option:heavy_minus_sign:The options for this request.

Response

*components.ActivityResponse, error

Errors

Error TypeStatus CodeContent Type
sdkerrors.BadRequestResponseError400application/json
sdkerrors.UnauthorizedResponseError401application/json
sdkerrors.ForbiddenResponseError403application/json
sdkerrors.NotFoundResponseError404application/json
sdkerrors.InternalServerResponseError500application/json
sdkerrors.APIError4XX, 5XX*/*