Drive Promethic from any script or agent

Every Promethic account ships with a public API + a command-line tool. Read your prompts, run them with input, edit and create them. Free, included with every plan.

What you can do

Get started in 60 seconds

1. Sign in at app.getpromethic.com.
2. Mint a key in Settings → Developer Keys. Pick the scopes you want (read, execute, write) and copy the secret — you'll only see it once.
3. Install the CLI:

   npm install -g @soulwarestudio/promethic-cli

4. Log in:

   promethic auth login   # paste your pmk_... key

5. Run your first prompt:

   promethic prompts list
   promethic run <prompt-id> --input "summarize this article"

Or skip the CLI — talk to the API directly with curl:

curl -H "X-API-Key: pmk_..." \
  https://api.getpromethic.com/api/v2/public/prompts

Full reference at api.getpromethic.com/agent-api-v1.

Connect agents directly (hosted MCP)

Promethic also runs a hosted MCP server, so Claude Desktop, Cursor, Claude iOS, claude.ai web, ChatGPT (Pro/Enterprise), and Codex CLI can call your prompts directly — no CLI, no install. Same pmk_... key, all 24 tools (list / get / create / update prompts, run / revise / finalize prompt runs, delete and patch records, upload attachments, browse the model catalog).

Connect Claude Desktop or Cursor

Add this entry to claude_desktop_config.json (or the equivalent Cursor MCP config) and restart the client:

{
  "mcpServers": {
    "promethic": {
      "url": "https://mcp.getpromethic.com/v1",
      "headers": {
        "Authorization": "Bearer pmk_..."
      }
    }
  }
}

Connect Claude iOS, claude.ai web, or ChatGPT (OAuth)

These clients use OAuth 2.1 instead of bearer-key paste. In each app's Settings → Connectors (or equivalent), add a new MCP connector with:

• URL: https://mcp.getpromethic.com/v1
• Auth: leave Authorization URL / Client ID blank — the client discovers them automatically.

On Connect, a popup opens to app.getpromethic.com/oauth-authorize. Sign in (or create an account), review the requested scopes, click Allow. The popup closes and the connector shows as Connected. Re-adding the same connector later skips the consent screen automatically.

Revoke an OAuth connection any time at app.getpromethic.com → Settings → Connected Apps. The revoke kills active sessions and child tokens immediately.

ChatGPT availability note: Custom MCP connectors are a Pro / Enterprise feature as of 2026-05; the ChatGPT free tier doesn't yet support custom MCP servers. Connectors added via web ChatGPT also appear in the iOS / Android apps for the same account.

Connect Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.promethic]
url = "https://mcp.getpromethic.com/v1"
[mcp_servers.promethic.headers]
Authorization = "Bearer pmk_..."

The server speaks MCP Streamable HTTP (spec 2025-03-26) and returns a connection-bound session token after initialize. Per-tool grants are available as opt-in hardening on the same Developer Keys screen. Full hosted-MCP reference at api.getpromethic.com/agent-api-v1.