@caffinate/mcp-server

MCP server for Caffinate — build, publish, install, fork, and run AI workflows directly from inside your agent runtime.

Setup

1. Create an API key

Sign in at caffinate.vercel.app, go to Settings → API Keys, and mint a new key. You'll see the full caff_… value once; copy it.

2. Add the server to your agent runtime config

Most MCP-compatible runtimes read a JSON config like this:

{
  "mcpServers": {
    "caffinate": {
      "command": "npx",
      "args": ["-y", "@caffinate/mcp-server"],
      "env": {
        "CAFFINATE_API_KEY": "caff_your_key_here"
      }
    }
  }
}

Restart the runtime. The tools below become available in-session.

Tool surface

For consumers

| Tool | Purpose | |---|---| | caffinate_auth_status | Verify the API key is live; see which user you're authed as | | caffinate_search | Full-text search of the marketplace feed | | caffinate_workflow_info | Full metadata for a workflow by slug | | caffinate_install | Install a workflow into the current project | | caffinate_list_installed | Show what's installed in this project | | caffinate_list_starter_kits | List workflows in the Starter Kit category — one-install deployable scaffolds | | caffinate_run | Execute an installed workflow + record the run server-side | | caffinate_fork | Fork a workflow as your own editable copy (lineage recorded) |

For creators

| Tool | Purpose | |---|---| | caffinate_workflow_init | Scaffold a new workflow package in the current project | | caffinate_pack_preview | Validate a workflow directory without uploading | | caffinate_publish | Pack + upload + publish the workflow end-to-end |

How a workflow package works

A workflow is a directory with a caffinate.json manifest and one or more Markdown prompt files. Full manifest schema in @caffinate/workflow-format.

Creator economics

Split, enforced in backend code:

| Recipient | Share | |---|---| | Creator (direct) | 80% | | Platform | 18% | | Community burn | 2% |

Fork royalty to ancestors, per install of a descendant: 12% / 5% / 2% / 1% at depths 1–4.

License

MIT. Source in packages/mcp-server.