आयुAAYU Developer documentation · MCP
Public connector live

Your record.
Your AI.

Give Claude, Claude Desktop, or another remote MCP client read-only access to your authorised AAYU record. Paste one URL, authenticate in your browser, and keep every credential outside the conversation.

Live public endpoint. No source checkout, Python installation, local process, client ID, secret, or copied token is required.
01 · Requirements

Before you begin

  • An AAYU account.
  • Claude Free, Pro, Max, Team or Enterprise, or another OAuth-capable remote MCP client.

Authentication uses your normal AAYU sign-in on AAYU's own consent page. Claude never receives your password.

02 · Setup

Connect Claude

1. Add the public endpoint

https://api.brainalyse.tech/mcp

In Claude, open Customize → Connectors, select + → Add custom connector, name it AAYU, and paste the URL. Team and Enterprise owners add it from Organization settings → Connectors → Custom → Web.

2. Authenticate

Select Connect. AAYU opens a secure browser page showing the requested read-only permissions. Sign in and choose Approve and connect.

3. Enable AAYU in a conversation

Use the + button beside the chat composer, open Connectors, and enable AAYU.

03 · Test

Verify the connection

Open a new Claude conversation and try:

Use AAYU to show today's recovery, sleep and nutrition record. Tell me which fields are missing, and do not give medical advice.

Claude should ask permission before using the tool and identify AAYU as the source. If it answers without a tool call, confirm the AAYU server appears in Claude's connected-tools list.

04 · Tool reference

Eight read-only tools

get_daily_record

Recovery, sleep, nutrition totals, goals and streak for an ISO date.

get_daily_brief

AAYU's cached plain-language brief for an ISO date.

get_today_tasks

Today's derived and custom checklist with completion state.

get_personal_insights

Evidence-labelled correlations from the user's own record.

list_strength_exercises

Logged exercises with latest and best performance.

get_strength_progress

Daily top sets, estimated 1RM and last session for one exercise.

get_current_program

The trainee's current published training programme.

get_connected_sources

Status of imported sources such as WHOOP and health platforms.

05 · Boundaries

Security model

The model never receives the MCP credential as a tool argument.

OAuth uses PKCE, one-use five-minute codes, one-hour audience-bound access tokens, and rotating 30-day refresh tokens. AAYU stores only hashes.

  • Every exposed tool is read-only.
  • The connector cannot log meals or workouts, edit a programme, place an order or message a coach.
  • The public endpoint and every OAuth endpoint use HTTPS.
  • AAYU output can be wrong and must not be treated as diagnosis or medical advice.
  • Disconnecting AAYU in Claude revokes the connector grant.

Read the full AI security boundary and privacy policy.

06 · Help

Troubleshooting

Claude does not show AAYU tools

Confirm the connector URL is exactly https://api.brainalyse.tech/mcp, then disconnect and add it again.

The sign-in page does not open

Allow pop-ups for Claude, then select Connect again. Do not enter your AAYU password anywhere except api.brainalyse.tech.

07 · Developers

Local connector option

The previous local stdio connector remains available for AAYU developers and offline protocol testing. It requires the source checkout, Python and a one-time uv run python -m app.mcp_login browser pairing step.

Public read scopes are record:read, training:read, programme:read and connections:read. Any future write scope will be separate and require confirmation for every consequential action.

Get MCP support