Ageless Minds AcademyAgeless Minds Academy

Developer docs

Connect an AI assistant to your Ageless Minds account

Ageless Minds Academy exposes a Model Context Protocol (MCP) server so ChatGPT, Claude, Cursor, or any MCP-compatible client can act on your SOAP notes, study planner, and APA checker — as you, with your data, over OAuth.

Endpoints

MCP endpoint
https://www.agelessmindsacademy.com/mcp
Transport
Streamable HTTP (MCP spec 2025-06-18)
Auth
OAuth 2.1 with dynamic client registration. Every tool call requires a user access token.
Resource metadata
/.well-known/oauth-protected-resource

Security model

  • Tools are gated by OAuth. Anonymous calls are rejected — every request must present a bearer access token issued to a signed-in account.
  • Tokens are user-scoped. Data reads and writes go through Supabase Row Level Security using the caller's identity — a client can only touch rows owned by the signed-in user.
  • Consent is explicit. The first time a client connects, you'll be redirected to /.lovable/oauth/consent to approve it.
  • Access tokens are never returned in tool output or logs. Revoke a client any time by disconnecting it from your assistant.
  • Destructive tools are marked with the standard MCP destructiveHint annotation. Creating a note or study session is a non-destructive write; there are no delete tools.

Connect a client

  1. In your MCP-compatible assistant (ChatGPT Desktop, Claude, Cursor, Codex), add a new remote MCP server with the URL https://www.agelessmindsacademy.com/mcp.
  2. The client will register itself dynamically and open the OAuth flow. Sign in with your Ageless Minds account.
  3. Review the consent screen. Approve to grant the client access as you.
  4. You're connected. Ask the assistant to try app_info first to confirm the tool surface.

Discovering tools

MCP clients auto-discover tools via tools/list on the endpoint. The catalog below matches what your assistant will see. Every tool description and JSON schema is served live from /mcp.

Available tools

app_info

App info

Read-only

Returns platform metadata and the list of study features available.

No parameters.

Returns

JSON with `app`, `purpose`, and `features[]`.

list_soap_notes

List SOAP notes

Read-only

Signed-in student's saved SOAP notes and care plans, newest first.

Parameters

  • limit — integeroptionalMax notes to return. Default 20.

Returns

Array of `{ id, title, note_type, updated_at }`.

get_soap_note

Get SOAP note

Read-only

Fetch a single note by id, including every section and AI feedback.

Parameters

  • id — uuidrequiredThe note id.

Returns

Full note record.

create_soap_note

Create SOAP note

Write

Create a SOAP note or care plan under the signed-in student's account.

Parameters

  • note_type — 'soap' | 'careplan'requiredKind of note.
  • title — string (1–200)requiredShort title.
  • patient_context — string (≤4000)optionalOptional patient context.
  • subjective — string (≤15000)optionalS section text.
  • objective — string (≤15000)optionalO section text.
  • assessment — string (≤15000)optionalA section text.
  • plan — string (≤15000)optionalP section text.

Returns

`{ note: { id, title, note_type, updated_at } }`.

list_study_sessions

List study sessions

Read-only

Planned and completed study sessions ordered by scheduled date.

Parameters

  • status — 'all' | 'planned' | 'completed'optionalFilter. Default all.
  • limit — integeroptionalMax sessions. Default 30.

Returns

Array of study_session rows.

create_study_session

Create study session

Write

Schedule a study session on a given date with duration and topics.

Parameters

  • title — string (1–200)requirede.g. 'Antidepressants review'.
  • scheduled_date — YYYY-MM-DDrequiredISO date.
  • duration_minutes — integer 5–600requiredPlanned duration.
  • scheduled_time — HH:MM (24h)optionalOptional start time.
  • focus_topics — string[] (≤15)optionalShort topic tags.
  • link_type — stringoptionale.g. 'pharm-flashcards', 'soap-coach', 'exam', 'apa-checker', 'none'.
  • notes — stringoptionalFree-form notes.

Returns

New study_session row.

study_progress

Study progress summary

Read-only

Aggregate view: planned vs completed sessions, planned vs logged minutes, top focus topics, recent completions.

Parameters

  • days — integer 1–365optionalLook-back window for recent completions. Default 30.

Returns

`{ window_days, totals:{sessions,planned,completed,completion_rate}, minutes:{planned,logged,adherence}, top_topics[], recent_completions[] }`.

check_apa_citation

APA 7 citation checker

Read-only

Validate up to 10 APA 7 reference entries. Returns per-citation score, issues, corrected reference, and an in-text example.

Parameters

  • citations — string[] (1–10, each 3–2000 chars)requiredReference-list entries to check.

Returns

`{ results: [{ input, source_type, is_valid, score, issues[{severity,field,message}], corrected, corrected_markdown, in_text, notes }] }`.

Troubleshooting

  • 401 Unauthorized — your client isn't sending a bearer token. Reconnect the server and complete the OAuth flow.
  • Empty results — the tool reads your account only, so a fresh account will have nothing to list. Create data in the app first, or use create_soap_note / create_study_session.
  • AI credits exhausted — the APA tool uses the platform AI gateway. Refill credits in Settings.