Skip to main content
Glama
ldastey-dev

Devin MCP Server

by ldastey-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Devin MCP Server

A Python MCP (Model Context Protocol) server that wraps all three Devin API versions (v1, v2, v3beta1) with multi-organisation support.

Features

  • All API versions: v1 (org-scoped), v2 (enterprise admin), v3beta1 (RBAC/service users)

  • Multi-org: Route requests to different organisations via the org parameter

  • Config-driven: JSON config file for PAT tokens (excluded from source control)

  • Conditional registration: Only registers tools for API versions you have tokens for

Related MCP server: Nullplatform API MCP

Setup

1. Install dependencies

cd devin-mcp
pip install -e .
# or
pip install -r requirements.txt

2. Create config file

Copy the example and fill in your tokens:

cp config.example.json config.json

Edit config.json:

{
  "default_org": "my-org",
  "organizations": {
    "my-org": {
      "description": "Primary organisation",
      "tokens": {
        "v1": "apk_user_YOUR_V1_TOKEN",
        "v2": "apk_user_YOUR_V2_ENTERPRISE_ADMIN_TOKEN",
        "v3": "cog_YOUR_V3_SERVICE_USER_TOKEN"
      }
    },
    "other-org": {
      "description": "Secondary organisation",
      "tokens": {
        "v1": "apk_YOUR_OTHER_ORG_TOKEN"
      }
    }
  }
}

Note: config.json is in .gitignore and will not be committed.

You can also set DEVIN_MCP_CONFIG=/path/to/config.json to use a config file from any location.

3. Configure your MCP client

VS Code / Copilot

Add to your MCP settings (settings.json or .vscode/mcp.json):

{
  "mcpServers": {
    "devin": {
      "command": "python",
      "args": ["-m", "devin_mcp.server"],
      "cwd": "/path/to/devin-mcp/src"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "devin": {
      "command": "python",
      "args": ["-m", "devin_mcp.server"],
      "cwd": "/path/to/devin-mcp/src"
    }
  }
}

Or using the installed entry point:

{
  "mcpServers": {
    "devin": {
      "command": "devin-mcp"
    }
  }
}

Available Tools

v1 Tools (Org-Scoped)

Tool

Description

create_session

Create a new Devin session

get_session

Get session details by ID

list_sessions

List sessions

send_session_message

Send a message to an active session

update_session_tags

Update session tags

upload_attachment

Upload a file for use in sessions

list_secrets

List org secret metadata

create_secret

Create a secret

delete_secret

Delete a secret

list_knowledge

List knowledge items

create_knowledge

Create a knowledge item

delete_knowledge

Delete a knowledge item

list_playbooks

List playbooks

create_playbook

Create a playbook

delete_playbook

Delete a playbook

v2 Tools (Enterprise Admin)

Tool

Description

enterprise_list_organizations

List organisations

enterprise_create_organization

Create an organisation

enterprise_list_members

List members

enterprise_invite_members

Invite members

enterprise_session_insights

Get session insights

enterprise_consumption_cycles

Get billing cycles

enterprise_audit_logs

Get audit logs

enterprise_metrics

Get analytics metrics

enterprise_list_api_keys

List service API keys

enterprise_list_groups

List IdP groups

enterprise_list_playbooks

List enterprise playbooks

enterprise_set_git_permission

Set git repo permissions

v3 Tools (RBAC / Service Users)

Tool

Description

v3_get_self

Get authenticated service user info

v3_list_organizations

List organisations

v3_get_organization

Get organisation details

v3_list_sessions

List org sessions

v3_get_session

Get session details

v3_create_session

Create a session

v3_send_session_message

Message a session

v3_terminate_session

Terminate a session

v3_archive_session

Archive a session

v3_list_enterprise_service_users

List enterprise service users

v3_create_enterprise_service_user

Create enterprise service user

v3_list_org_service_users

List org service users

v3_audit_logs

Get audit logs

v3_consumption_cycles

Get billing cycles

v3_consumption_daily

Get daily consumption

v3_list_enterprise_notes

List enterprise knowledge

v3_list_org_notes

List org knowledge

v3_list_enterprise_playbooks

List enterprise playbooks

v3_list_org_playbooks

List org playbooks

v3_list_org_secrets

List org secrets

v3_list_git_connections

List git connections

v3_list_git_permissions

List git permissions

v3_list_enterprise_users

List enterprise users

v3_list_org_users

List org users

v3_list_enterprise_idp_groups

List IdP groups

v3_list_roles

List roles

v3_usage_metrics

Get usage metrics

v3_queue_status

Get queue status

v3_list_org_tags

List org session tags

Multi-Organisation Usage

Every tool accepts an optional org parameter. When omitted, the default_org from config is used.

"Create a Devin session in my-org to review PR #42"
→ Uses default org token

"List sessions in other-org"
→ Routes to other-org's token

Token Types

API Version

Token Prefix

Type

v1

apk_user_ or apk_

Personal or Service API Key

v2

apk_user_

Enterprise Admin Personal Key

v3

cog_

Service User Credential

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • OpenAI MCP Server

    NimbleBrainInc
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Provides comprehensive access to OpenAI's API capabilities including chat completions, image generation, embeddings, text-to-speech, speech-to-text, vision analysis, and content moderation. Enables users to interact with GPT models, DALL-E, Whisper, and other OpenAI services through natural language commands.
    -

  • Datadog MCP Server

    ppandrangi
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with Datadog APIs through natural language, supporting full CRUD operations on metrics, monitors, dashboards, logs, infrastructure, and more.
    4
    MIT