@co-journey/mcp

CoJourney MCP server — commit your local build to CoJourney as a draft, straight from your AI coding agent. You then activate the draft into a version on the CoJourney website.

Status: evolving with the MCP PRD. Start with cojourney_fetch_guide. Also: create/upload/list/link, feedback, and release tools. Only stdio transport; Cursor one-click install wired.

Configuration

The server reads two environment variables (the onboarding deeplink sets both for you):

| Env | Required | Meaning | |-----|----------|---------| | COJOURNEY_API_KEY | yes | Your CoJourney API key (cj_...), generated in CoJourney settings. Sent as X-API-Key. | | COJOURNEY_API_BASE | no | CoJourney backend base URL. Defaults to http://localhost:8080 for local dev. |

Example MCP config entry:

{
  "command": "npx",
  "args": ["-y", "@co-journey/mcp"],
  "env": {
    "COJOURNEY_API_KEY": "cj_...",
    "COJOURNEY_API_BASE": "https://your-cojourney-origin"
  }
}

Develop

npm install
npm test        # vitest
npm run build   # tsc -> dist/

This package is developed inside the CoJourney monorepo (mcp/). The monorepo copy is the only place to edit it.