Cathexis for Developers

Somatic intelligence, machine-readable.

Cathexis runs a local MCP server on the user’s device. Your AI agents can access real-time somatic state, territory profiles, regulation patterns, and learning progress — always with explicit user consent, full transparency, and zero data leaving the phone.

Built on three unbreakable principles

Local-first

Runs on 127.0.0.1. No cloud relay. No third-party services. Your agent talks directly to the user’s device.

User-controlled

Every connection is visible and manageable inside Cathexis. Users grant, limit, or revoke access with one tap. Revocation is instant and total.

Standards-based

JSON-RPC 2.0 over HTTP/SSE. Zero-config discovery via Bonjour/mDNS. Works natively with Claude, Grok, OpenAI, and any custom MCP client.

Tools

Eleven observational tools across three permission levels. All responses use strictly neutral, body-based language — no diagnoses, no clinical claims. Just the raw signals the nervous system is generating.

  • Current somatic activation, active territory, last check-in summary

  • Learning level, intervention response data

  • Recommended intervention based on current state

  • User's protective factor profile

  • Recent check-ins with zone/quality/intensity data

  • Contextual data, ecological pressure, life transitions

  • Prediction tracking results

  • Pattern detection results

  • Active prevention escalation state

  • 90-day rolling window, territory evolution, key transitions

  • Bayesian advancement history, mastery confidence

Resources

Four read-only data surfaces. No writes, no side effects.

cathexis://somatic_ontology The machine-readable Cathexis Somatic Ontology. 24 anatomical zones, 15 sensation qualities, 16 therapeutic territories, 7 primary affect systems, Markov blanket framework, theoretical foundations. Published at DOI: 10.5281/zenodo.18859897.

cathexis://territory_profile Bayesian territory probability distribution. Primary territory, confidence tier, secondary territories.

cathexis://intervention_catalog All available somatic practices: mechanism type, territory, learning level, duration.

cathexis://learning_progress Current program state: learning level (1–6), program day, advancement status.

somatic_context Prompt

The somatic_context prompt assembles everything — CSO vocabulary, territory context, regulation capacity, protective factors, active patterns — into a single context block your agent can use before any conversation. An agent that calls somatic_context at L3 understands the user's body in a way no generic assistant can.

Permission Levels

L1 — Engagement: Territory, learning level, program day. Auto-granted on connect, no consent required.

L2 — Intelligence: Regulation capacity, practice recommendations, protective factors. One-time consent per connection.

L3 — Patterns: Somatic patterns, prediction accuracy, prevention signals. Per-connection consent, 30-day expiry.

L4 — Full Timeline: Not available in 2.2. Coming in v3.0.

What is never shared

The following data is architecturally excluded at every permission level:

  • Substance use data

  • Medication names, doses, or schedules

  • Journal entries and free-text reflections

  • Raw body map coordinates

  • High-urgency prevention signals

  • Manic episode trajectory data

Privacy

Cathexis is a wellness app, not a medical device. All pattern data is observational — it describes what the user's body has been showing, not what is clinically true about them. No data is transmitted to Cathexis servers via MCP. The server runs on the user's device. Your agent talks directly to the phone.

Questions? support@cathexis.health

The Cathexis Somatic Ontology is published at DOI: 10.5281/zenodo.18859897 under CC BY-NC-SA 4.0.