RunAnalytics MCP Documentation

Endpoints

Private: https://aitracker.run/mcp: OAuth plus active Premium or trial access.

Public: https://aitracker.run/mcp/public: public shoe and tool catalog only.

OAuth discovery

• /.well-known/oauth-authorization-server
• /.well-known/oauth-protected-resource/mcp
• /mcp/oauth/register
• /mcp/oauth/authorize
• /mcp/oauth/token
• /mcp/oauth/revoke

Clients use authorization code with PKCE S256 and exact registered redirect URIs. Web-session and magic-link tokens are not accepted as MCP bearer tokens.

Private scopes

• mcp:profile.read
• mcp:activities.read
• mcp:analytics.read
• mcp:goals.read
• mcp:plans.read

Public running-shoe tools

• search_running_shoes
• get_running_shoe
• list_running_shoe_filters
• compare_running_shoes
• list_runanalytics_tools

Operational limits

Activity ranges are capped at 365 days, pages at 100 records, plan details at 32 weeks, shoe search at 50 results, comparison at four shoes, and tool execution at eight seconds. Private and public requests have separate distributed rate limits.