Skip to main content

Claude MCP connector

Status: Implemented
Last Updated: 2026-08-18

ARC exposes the same service layer used by the web app as an MCP server. Claude Desktop (or any MCP client) authorizes with OAuth2 PKCE and receives user-scoped tools.

User guide (setup, permissions, tool catalog, forms → webhooks): Connect Claude (MCP)

Endpoints (production)​

PathPurpose
https://arcos.corgicy.com/mcpMCP JSON-RPC
https://arcos.corgicy.com/authorizeOAuth authorize / approve / deny
https://arcos.corgicy.com/tokenOAuth token
https://arcos.corgicy.com/.well-known/oauthOAuth discovery
https://arcos.corgicy.com/registerDynamic client registration

Rules​

  • Call system_get_current_datetime before any scheduling, planning, or date math. Do not infer “today” from chat context. (Feature docs sometimes write this as system.get_current_datetime; the MCP tool name uses underscores.)
  • Use Brain (brain_*) for knowledge. Use context_* for LLM scratch. They coexist.
  • Tools return sanitised, user-scoped data from the existing services. Coverage: server/src/mcp/FEATURE_STATUS.md.
  • Core Brain tools and system_get_current_datetime are always on. Other domains are toggled in Settings → Developer.
  • brain_form_submit creates a database record and fires outgoing webhook brain_form_submitted for the form owner. See Outgoing webhooks.

Domains covered​

Planning, health, training, nutrition, finance, habits, tasks, journal, reading, meditation, wardrobe, plants, social, messaging, gamification, analytics, settings, Brain (core + extended + forms), context, coach, home, inventory, travel, and additional lifestyle modules. Full names: MCP user guide.