devin-api-mcp

MCP servers providing full Devin API coverage — manage sessions, knowledge, playbooks, secrets, schedules, and attachments programmatically from any MCP client — plus a documentation-only DeepWiki proxy.

The hosted Devin MCP server bundles documentation lookups together with session/platform management in one server. This package splits those concerns: the devin-api-* servers give you everything except docs, and the deepwiki proxy gives you docs only (so it can't be confused for a delegation tool).

Servers

This package exposes three MCP servers:

• devin-api-v1 — Legacy v1 API (19 tools). Uses a personal API key (apk_user_ prefix).

• devin-api-v3 — v3 Organization API (33 tools). Uses a service user key (cog_ prefix). Auto-discovers your org_id at startup via /v3/self.

• deepwiki — a read-only proxy to the upstream Devin MCP (https://mcp.devin.ai/mcp, personal key) that re-exposes ONLY ask_question, read_wiki_structure, and read_wiki_contents. Private repos work (it authenticates with your personal key), but session/platform tools are filtered out — there is no way to create or manage a Devin session through it. Set the upstream with DEEPWIKI_UPSTREAM_URL (default https://mcp.devin.ai/mcp) and optionally DEVIN_ORG_ID.

  {
    "mcpServers": {
      "deepwiki": {
        "command": "npx",
        "args": ["-y", "-p", "@jsklan/devin-api-mcp", "deepwiki"],
        "env": { "DEVIN_PERSONAL_API_KEY": "your_personal_key_here" }
      }
    }
  }

Related MCP server: jt-mcp-server

Setup

1. Get your API keys

Follow the Devin API authentication guide to generate your keys:

Note: The v1 server also accepts DEVIN_API_KEY as a fallback for backward compatibility.

2. Register with Claude Code

# v1 (personal API — sessions, knowledge, playbooks, secrets, attachments)
claude mcp add -s user -e DEVIN_PERSONAL_API_KEY=<your-personal-key> -- devin-api-v1 npx -y -p @jsklan/devin-api-mcp devin-api-v1

# v3 (organization API — adds schedules, more session tools)
claude mcp add -s user -e DEVIN_SERVICE_API_KEY=<your-service-key> -- devin-api-v3 npx -y -p @jsklan/devin-api-mcp devin-api-v3

Alternative: Install as a Claude Code plugin

1. Run /plugin in Claude Code

2. Go to Marketplaces → + Add Marketplace

3. Enter jsklan/devin-api-mcp

4. Go to Discover, find devin-api, and install it

Make sure DEVIN_PERSONAL_API_KEY and/or DEVIN_SERVICE_API_KEY are set in your environment. The plugin will start the MCP servers automatically and stay up to date.

3. Register with other MCP clients

Add to your MCP config (e.g. mcp.json):

{
  "mcpServers": {
    "devin-api-v1": {
      "command": "npx",
      "args": ["-y", "-p", "@jsklan/devin-api-mcp", "devin-api-v1"],
      "env": {
        "DEVIN_PERSONAL_API_KEY": "your_personal_key_here"
      }
    },
    "devin-api-v3": {
      "command": "npx",
      "args": ["-y", "-p", "@jsklan/devin-api-mcp", "devin-api-v3"],
      "env": {
        "DEVIN_SERVICE_API_KEY": "your_service_key_here"
      }
    }
  }
}

Tools

v1 Server (19 tools)

Sessions

Knowledge

Playbooks

Secrets

Attachments

v3 Server (33 tools)

The v3 server includes all the same categories as v1 (with expanded session tools) plus schedules and an additional attachment tool. All operations are scoped to your organization.

Sessions (14 tools)

Expanded session management including listing by status, bulk operations, and session events.

Knowledge (4 tools)

Same as v1 — list, create, update, delete.

Playbooks (5 tools)

Same as v1 — list, get, create, update, delete.

Secrets (3 tools)

Same as v1 — list, create, delete.

Schedules (5 tools)

Attachments (2 tools)

Upload and manage files for use in sessions.

API Coverage

• v1 server wraps the Devin REST API v1 — 19 tools across 5 categories.

• v3 server wraps the Devin REST API v3 — 33 tools across 6 categories. Enterprise (/v3/enterprise/...) and beta (/v3beta1/...) endpoints are intentionally excluded.

Written in TypeScript with Zod schema validation.

License

MIT