PRIMED · DEVELOPER PLATFORM

Developer
Documentation.

Developer documentation, API references, and Model Context Protocol (MCP) server specifications for Primed athletic coaching intelligence.

Specification v1.0.0Model Context ProtocolOAuth 2.1 (PKCE)Read-Only V1 Contract

FEATURED SPECIFICATION

The Primed MCP Connector provides an authenticated, read-only interface allowing AI assistants (such as Meta Muse, Claude, and OpenAI ChatGPT) to access an athlete’s canonical coaching decisions, planned training schedules, athletic recovery states, and completed workouts.

5 Canonical ToolsStreamable HTTP & SSEZero Split-Brain InvariantRFC 7807 Errors
Explore MCP Documentation

CANONICAL SERVICE ENDPOINTS

Endpoints & Discovery

MCP ServerPOSThttps://mcp.beprimed.ai/mcp
OAuth 2.1 Auth ServerGEThttps://auth.beprimed.ai/
Resource MetadataGEThttps://mcp.beprimed.ai/.well-known/oauth-protected-resource

CORE PRINCIPLES

Architectural Guarantees

Deterministic Authority

All coaching decisions originate from Primed’s deterministic engine (DailyCoachingDecisionService). External AI assistants consume and explain decisions; they never invent workouts or diverge from canonical records.

View Authority Architecture

Zero Split-Brain Invariant

All surfaces (iOS, Mac, Web, MCP assistants) consume identical canonical records. Dual-writes, out-of-band mutations, and unversioned fallbacks are prohibited by design.

Read Split-Brain Policy

100% Read-Only Contract

The connector exposes zero mutation or deletion tools in V1. It cannot alter training calendars, modify athlete profiles, or execute financial transactions.

Review Tool Classifications

Non-PHI Privacy by Design

Exposes only high-level athletic training parameters. Collects zero Protected Health Information (PHI) under HIPAA and no clinical diagnostic data.

Inspect Health Boundaries

Client Configuration

Ready-to-use configuration examples for Claude Desktop, Cursor, and custom HTTP/SSE MCP client implementations with token management.

Client Quickstart Guide

RFC 7807 Error Handling

Standardized JSON-RPC machine-readable canonical codes, actionable recovery steps, and strict rate limit enforcement.

Error Code Reference

DEVELOPER SUPPORT

Questions or Integration Inquiries?

Our engineering team supports developers building MCP clients and assistant integrations.

support@beprimed.ai

SECURITY & COMPLIANCE

Security Incident Reporting

Confirmed incidents involving athlete data are escalated within 48 hours per Meta Policy § 4.8.

security@beprimed.ai