Skip to main content

Cerina MCP Server

MCP (Model Context Protocol) server that exposes the CBT Clinical Review Multi-Agent System as tools for AI assistants like Claude Desktop.

Features

  • create_cbt_exercise: Create CBT exercises using the multi-agent workflow
  • list_exercises: List approved exercises from the database
  • get_session_status: Check status of exercise creation sessions
  • approve_exercise: Approve exercises awaiting human review

Prerequisites

  1. Python 3.13+
  2. uv package manager
  3. Cerina Foundry backend running at http://localhost:8000

Installation

cd mcp
uv sync

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

Daily Use

{
  "mcpServers": {
    "cerina-mcp": {
      "command": "uvx",
      "args": ["cerina-foundry"]
    }
  }
}

Development

{
  "mcpServers": {
    "cerina-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/jagjeevankashid/Developer/cerina/mcp",
        "run",
        "cerina-foundry"
      ],
      "env": {
        "CERINA_BACKEND_URL": "http://localhost:8000/api/v1",
      }
    }
  }
}

Environment Variables

Variable Default Description
CERINA_BACKEND_URL http://localhost:8000/api/v1 Backend API URL
CERINA_AUTO_APPROVE false Auto-approve without human review
CERINA_POLL_INTERVAL 2.0 Seconds between status polls
CERINA_MAX_POLL_ATTEMPTS 300 Max polls before timeout (~10 min)

Usage Examples

Once configured in Claude Desktop:

Create an Exercise

"Ask Cerina Foundry to create a sleep hygiene protocol for patients with insomnia"

List Exercises

"Show me the approved CBT exercises for anxiety"

Check Status

"What's the status of session abc123?"

Approve Pending Exercise

"Approve the exercise in session xyz789"

Development

Run the server manually:

uv run cerina-foundry

Test with MCP inspector:

npx @modelcontextprotocol/inspector uv --directory . run cerina-foundry

Metadata

Release files for cerina-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cerina-mcp 0.1.1
File Size Uploaded Provenance
cerina_mcp-0.1.1.tar.gz 32.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for cerina-mcp 0.1.1
File Interpreter ABI Platform
cerina_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 45.8 kB

Release files / cerina_mcp-0.1.1.tar.gz

Download URL cerina_mcp-0.1.1.tar.gz
Size 32.9 kB
Tags Source
SHA-256 checksum
How to use checksums
c80d04b721a0be9520b05952a2dc2ee0bb401455eb87d453ea532eb10d16b7c1
BLAKE2b-256 checksum
How to use checksums
69c1e763579743285404820bc3ccf12c7d2a3e5ae215a21a4584c668103e0c55
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / cerina_mcp-0.1.1-py3-none-any.whl

Download URL cerina_mcp-0.1.1-py3-none-any.whl
Size 13.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3daa5e2b0fec90129f450b6660f2411e7e4206715aa074469ac73804a2a378f5
BLAKE2b-256 checksum
How to use checksums
8178c1a4015d5a34439688ed90e76f855540e09f89737ce9178354078f582af5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Security for cerina-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page