ProfileScribe MCP

profilescribe-mcp is the local stdio MCP bridge for ProfileScribe. It lets a terminal MCP client talk to a user's ProfileScribe account while the user's own agent runtime pays model and compute costs.

The bridge reads MCP JSON-RPC messages on stdin, forwards them to ProfileScribe's hosted MCP endpoint, and writes MCP responses back to stdout.

Install

go install github.com/razroo/profilescribe-mcp/cmd/profilescribe-mcp@latest

From a local checkout:

make build

Configuration

Create a scoped token from ProfileScribe's /agents page. For terminal use, the token should include mcp:tools plus the read/write scopes for the tools you want to call.

Required:

PROFILESCRIBE_AGENT_TOKEN=psagt_...

Optional:

PROFILESCRIBE_MCP_URL=https://profilescribe.com/api/mcp
PROFILESCRIBE_API_URL=http://localhost:8080

PROFILESCRIBE_MCP_URL defaults to production. If it is unset and PROFILESCRIBE_API_URL is set, the bridge appends /api/mcp for local development.

Install in Coding Agents

After installing the binary, use profilescribe-mcp as the stdio MCP command. If it is not on your PATH, use the full path to the binary or bin/profilescribe-mcp from a local checkout.

Claude Code

One-line install:

claude mcp add -s user \
  -e PROFILESCRIBE_AGENT_TOKEN=psagt_... \
  -e PROFILESCRIBE_MCP_URL=https://profilescribe.com/api/mcp \
  profilescribe -- profilescribe-mcp

Uninstall:

claude mcp remove profilescribe

Or manually add to .mcp.json for a project-level config or ~/.claude/settings.json for a global config:

{
  "mcpServers": {
    "profilescribe": {
      "command": "profilescribe-mcp",
      "env": {
        "PROFILESCRIBE_AGENT_TOKEN": "psagt_...",
        "PROFILESCRIBE_MCP_URL": "https://profilescribe.com/api/mcp"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "profilescribe": {
      "command": "profilescribe-mcp",
      "env": {
        "PROFILESCRIBE_AGENT_TOKEN": "psagt_...",
        "PROFILESCRIBE_MCP_URL": "https://profilescribe.com/api/mcp"
      }
    }
  }
}

To uninstall, remove the profilescribe entry from the config file.

OpenAI Codex

Add to your Codex MCP configuration:

[mcp_servers.profilescribe]
command = "profilescribe-mcp"

[mcp_servers.profilescribe.env]
PROFILESCRIBE_AGENT_TOKEN = "psagt_..."
PROFILESCRIBE_MCP_URL = "https://profilescribe.com/api/mcp"

To uninstall, remove the profilescribe entry from the config file.

Cursor

Open Settings -> MCP -> Add new MCP server, or add to .cursor/mcp.json:

{
  "mcpServers": {
    "profilescribe": {
      "command": "profilescribe-mcp",
      "env": {
        "PROFILESCRIBE_AGENT_TOKEN": "psagt_...",
        "PROFILESCRIBE_MCP_URL": "https://profilescribe.com/api/mcp"
      }
    }
  }
}

To uninstall, remove the entry from MCP settings.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "profilescribe": {
      "command": "profilescribe-mcp",
      "env": {
        "PROFILESCRIBE_AGENT_TOKEN": "psagt_...",
        "PROFILESCRIBE_MCP_URL": "https://profilescribe.com/api/mcp"
      }
    }
  }
}

To uninstall, remove the entry from the config file.

VS Code / Copilot

One-line install:

code --add-mcp '{"name":"profilescribe","command":"profilescribe-mcp","env":{"PROFILESCRIBE_AGENT_TOKEN":"psagt_...","PROFILESCRIBE_MCP_URL":"https://profilescribe.com/api/mcp"}}'

Or add to .vscode/mcp.json:

{
  "servers": {
    "profilescribe": {
      "command": "profilescribe-mcp",
      "env": {
        "PROFILESCRIBE_AGENT_TOKEN": "psagt_...",
        "PROFILESCRIBE_MCP_URL": "https://profilescribe.com/api/mcp"
      }
    }
  }
}

To uninstall, remove the entry from MCP settings or delete the server from the MCP panel.

Other MCP Clients

Any MCP client that supports stdio transport can use ProfileScribe MCP. The server config is:

{
  "command": "profilescribe-mcp",
  "env": {
    "PROFILESCRIBE_AGENT_TOKEN": "psagt_...",
    "PROFILESCRIBE_MCP_URL": "https://profilescribe.com/api/mcp"
  }
}

To uninstall, remove the server entry from your client's MCP configuration.

Tools

ProfileScribe currently exposes:

• read_profile
• read_sources
• add_source
• update_source
• propose_profile_edit
• create_timeline_draft

There is intentionally no publish tool. Agents can draft or propose; users approve inside ProfileScribe.

Development

make fmt
make test
make build