25 MCP tools for live project context. Resolves @services, @read, @memory, @drift directives into pre-rendered facts before AI coding assistants start a session. Works with Claude Code, Cursor, Copilot, Aider. pip install perseus-ctx. MIT.

How to connect

How to connect perseus to Claude

The server address to paste into Claude settings:

https://perseus.run.tools

Open Claude (claude.ai or the desktop app).
Go to Settings → Connectors.
Click Add custom connector.
Paste the server address copied below into Remote MCP server URL and click Add.
In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect perseus to ChatGPT

The server address to paste into ChatGPT settings:

https://perseus.run.tools

Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
Open Settings → Connectors and click Create.
Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect perseus to Cursor

The server address to paste into Cursor settings:

https://perseus.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

perseus_agora	Task board from tasks/*.md
perseus_auto-skill	Instruct agent to load a skill before work begins
perseus_date	Current date/time
perseus_drift	Oracle drift report
perseus_env	Embed environment variable
perseus_health	Context maintenance report
perseus_inbox	Agent message inbox
perseus_include	Include and render another file
perseus_list	List directory or structured data
perseus_mason	Mason code architecture concept map (feature→file)
perseus_memory	Mnēmē v2 — unified memory search + narrative + federation
perseus_mneme	Recall persistent memories via Mnēmē BM25
perseus_perseus	Fetch rendered context from a remote Perseus instance
perseus_prompt	System prompt block
perseus_read	Embed file contents
perseus_services	Health-check listed services
perseus_session	Recent session digests
perseus_skills	List available skills
perseus_tool	Run an allowlisted external tool
perseus_tooltrim	Tool metadata awareness — filtered toolset descriptions
perseus_tree	Tree view of directory
perseus_validate	Validate a rendered block against a schema
perseus_waypoint	Latest checkpoint summary
perseus_get_context	Return the full rendered Perseus context for the workspace.
perseus_get_health	Run Daedalus context-maintenance heuristics and return a health report.

perseus

What it can do

What data it sees

Do you need an account

How to connect

How to connect perseus to Claude

Authorization

How to connect perseus to ChatGPT

Authorization

How to connect perseus to Cursor

Authorization