Devin MCP

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Devin MCP credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

   Dashboard setup steps

   Register your Devin API key with Scalekit so it stores it securely and injects it into every request. Devin uses API key authentication — there is no redirect URI or OAuth flow.

   1. Get your Devin API key

      • Sign in to Devin and go to Settings → Devin API.
      • Click the API keys (legacy) tab.
      • Under Personal API key, click View key to reveal your key, or expand the dropdown to regenerate it.

      

      Keep your key private

      Devin API keys are tied to your account and have full access. Store the key in a secrets manager and never hard-code it in your source code. Use Devin Secrets to give Devin access to third-party credentials instead.

   2. Create a connection in Scalekit

      • In Scalekit dashboard, go to AgentKit → Connections → Create Connection. Find Devin MCP and click Create.
      • Note the Connection name — you will use this as connection_name in your code (e.g., devinmcp).
      • Click Save.

   3. Add a connected account

      Connected accounts link a specific user identifier in your system to their Devin API key. Add them via the dashboard for testing, or via the Scalekit API in production.

      Via dashboard (for testing)

      • Open the connection you created and click the Connected Accounts tab → Add account.
      • Fill in:
        • Your User’s ID — a unique identifier for this user in your system (e.g., user_123)
        • API Key — the Devin API key from step 1
      • Click Create Account.

      Via API (for production)

      Node.js

      import { Scalekit } from '@scalekit-sdk/node';
      
      const scalekit = new Scalekit(
        process.env.SCALEKIT_ENV_URL,
        process.env.SCALEKIT_CLIENT_ID,
        process.env.SCALEKIT_CLIENT_SECRET,
      );
      
      // Never hard-code credentials — read from secure storage or user input
      const devinApiKey = getUserDevinApiKey(); // retrieve from your secure store
      
      await scalekit.actions.upsertConnectedAccount({
        connectionName: 'devinmcp',
        identifier: 'user_123',
        credentials: {
          username: devinApiKey,
        },
      });

      Python

      import os
      from scalekit import ScalekitClient
      
      scalekit_client = ScalekitClient(
          env_url=os.environ["SCALEKIT_ENV_URL"],
          client_id=os.environ["SCALEKIT_CLIENT_ID"],
          client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
      )
      
      # Never hard-code credentials — read from secure storage or user input
      devin_api_key = get_user_devin_api_key()  # retrieve from your secure store
      
      scalekit_client.actions.upsert_connected_account(
          connection_name="devinmcp",
          identifier="user_123",
          credentials={"username": devin_api_key},
      )

      Production usage tip

      In production, call upsert_connected_account (Python) / upsertConnectedAccount (Node.js) when a user connects their Devin account — for example, on an integrations settings page in your app.

4. Make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'devinmcp'
   const identifier = 'user_123'
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'devinmcp_devin_session_search',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "devinmcp"
   identifier = "user_123"
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="devinmcp_devin_session_search",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Setting find — Find a Devin webapp setting and get a deep-link URL to it
• Manage devin review, devin oncall, devin code scan — Trigger a Devin Review for a pull/merge request, or fetch its latest review status
• Read wiki structure, wiki contents — Get a list of documentation topics for a GitHub repository
• List integrations, available repos — List all native integrations and MCP servers for the organization with status and settings
• Wiki generate — Generate a codebase wiki for a repository and wait for it to complete
• Search devin session — Search and filter Devin sessions by date, tags, playbook, schedule, or user

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

devinmcp_ask_question#Ask any question about a GitHub repository and get an AI-powered, context-grounded response.2 params▾

Ask any question about a GitHub repository and get an AI-powered, context-grounded response.

NameTypeRequiredDescription

questionstringrequiredNo description.

repoNamestringrequiredNo description.

devinmcp_devin_automation_manage#Manage Devin automations that run Devin in response to events (GitHub, Slack, Linear, schedules, webhooks) — list, get, create, update, delete, or run them.23 params▾

Manage Devin automations that run Devin in response to events (GitHub, Slack, Linear, schedules, webhooks) — list, get, create, update, delete, or run them.

NameTypeRequiredDescription

actionstringrequiredNo description.

actionsstringoptionalNo description.

afterstringoptionalNo description.

agent_typesstringoptionalNo description.

automation_idstringoptionalNo description.

concurrencystringoptionalNo description.

creator_idstringoptionalNo description.

enabledstringoptionalNo description.

event_datastringoptionalNo description.

event_typestringoptionalNo description.

firststringoptionalNo description.

limitsstringoptionalNo description.

metadatastringoptionalNo description.

namestringoptionalNo description.

notificationsstringoptionalNo description.

promptstringoptionalNo description.

run_asstringoptionalNo description.

searchstringoptionalNo description.

security_profilestringoptionalNo description.

session_settingsstringoptionalNo description.

template_idstringoptionalNo description.

toolsstringoptionalNo description.

triggersstringoptionalNo description.

devinmcp_devin_code_scan_manage#Manage Devin code scans and scan profiles — list scans and findings, manage profiles, create scans, or remediate findings.27 params▾

Manage Devin code scans and scan profiles — list scans and findings, manage profiles, create scans, or remediate findings.

NameTypeRequiredDescription

actionstringrequiredNo description.

afterstringoptionalNo description.

communication_guidancestringoptionalNo description.

descriptionstringoptionalNo description.

exclude_globsstringoptionalNo description.

finding_idstringoptionalNo description.

firststringoptionalNo description.

hoststringoptionalNo description.

include_globsstringoptionalNo description.

ingestion_source_guidancestringoptionalNo description.

investigation_guidancestringoptionalNo description.

modestringoptionalNo description.

post_ingestion_guidancestringoptionalNo description.

profile_idstringoptionalNo description.

profile_namestringoptionalNo description.

remediation_guidancestringoptionalNo description.

repo_namestringoptionalNo description.

report_guidancestringoptionalNo description.

scan_idstringoptionalNo description.

scan_typestringoptionalNo description.

severitystringoptionalNo description.

statusstringoptionalNo description.

threat_model_guidancestringoptionalNo description.

time_afterstringoptionalNo description.

time_beforestringoptionalNo description.

triage_guidancestringoptionalNo description.

validation_guidancestringoptionalNo description.

devinmcp_devin_knowledge_manage#Manage Devin knowledge notes and suggestions — list, get, create, or update entries.18 params▾

Manage Devin knowledge notes and suggestions — list, get, create, or update entries.

NameTypeRequiredDescription

actionstringrequiredNo description.

afterstringoptionalNo description.

bodystringoptionalNo description.

contentstringoptionalNo description.

event_idstringoptionalNo description.

event_idsstringoptionalNo description.

firststringoptionalNo description.

folder_pathstringoptionalNo description.

limitstringoptionalNo description.

namestringoptionalNo description.

note_idstringoptionalNo description.

offsetstringoptionalNo description.

pinned_repostringoptionalNo description.

querystringoptionalNo description.

searchstringoptionalNo description.

since_daysstringoptionalNo description.

statusstringoptionalNo description.

triggerstringoptionalNo description.

devinmcp_devin_oncall_manage#View a Devin Oncall report's current responder membership, or a responder's open issues.6 params▾

View a Devin Oncall report's current responder membership, or a responder's open issues.

NameTypeRequiredDescription

actionstringrequiredNo description.

afterstringoptionalNo description.

firststringoptionalNo description.

order_bystringoptionalNo description.

report_idstringoptionalNo description.

responder_idstringoptionalNo description.

devinmcp_devin_playbook_manage#Manage Devin playbooks — list, get, create, or update playbook entries.9 params▾

Manage Devin playbooks — list, get, create, or update playbook entries.

NameTypeRequiredDescription

actionstringrequiredNo description.

afterstringoptionalNo description.

bodystringoptionalNo description.

contentstringoptionalNo description.

firststringoptionalNo description.

macrostringoptionalNo description.

playbook_idstringoptionalNo description.

structured_output_schemastringoptionalNo description.

titlestringoptionalNo description.

devinmcp_devin_review_manage#Trigger a Devin Review for a pull/merge request, or fetch its latest review status.3 params▾

Trigger a Devin Review for a pull/merge request, or fetch its latest review status.

NameTypeRequiredDescription

actionstringrequiredNo description.

pr_urlstringrequiredNo description.

commit_shastringoptionalNo description.

devinmcp_devin_schedule_manage#Manage scheduled Devin sessions — list, get, create, update, or delete schedules.16 params▾

Manage scheduled Devin sessions — list, get, create, update, or delete schedules.

NameTypeRequiredDescription

actionstringrequiredNo description.

agentstringoptionalNo description.

bypass_approvalstringoptionalNo description.

enabledstringoptionalNo description.

frequencystringoptionalNo description.

limitstringoptionalNo description.

namestringoptionalNo description.

notify_onstringoptionalNo description.

offsetstringoptionalNo description.

platformstringoptionalNo description.

playbook_idstringoptionalNo description.

promptstringoptionalNo description.

schedule_idstringoptionalNo description.

schedule_typestringoptionalNo description.

scheduled_atstringoptionalNo description.

target_devin_idstringoptionalNo description.

devinmcp_devin_session_create#Create one or more child Devin sessions via the REST API.5 params▾

Create one or more child Devin sessions via the REST API.

NameTypeRequiredDescription

sessionsarrayrequiredNo description.

devin_modestringoptionalNo description.

platformstringoptionalNo description.

reposstringoptionalNo description.

structured_output_schemastringoptionalNo description.

devinmcp_devin_session_events#Inspect events within a Devin session — list summaries, fetch full details, or search.14 params▾

Inspect events within a Devin session — list summaries, fetch full details, or search.

NameTypeRequiredDescription

actionstringrequiredNo description.

session_idstringrequiredNo description.

afterstringoptionalNo description.

categoriesstringoptionalNo description.

created_afterstringoptionalNo description.

created_beforestringoptionalNo description.

directionstringoptionalNo description.

event_idsstringoptionalNo description.

event_typesstringoptionalNo description.

firststringoptionalNo description.

limitstringoptionalNo description.

max_content_lengthstringoptionalNo description.

offsetstringoptionalNo description.

querystringoptionalNo description.

devinmcp_devin_session_gather#Wait for multiple Devin sessions to reach a settled state before returning.3 params▾

Wait for multiple Devin sessions to reach a settled state before returning.

NameTypeRequiredDescription

session_idsarrayrequiredNo description.

poll_interval_secondsintegeroptionalNo description.

timeout_secondsintegeroptionalNo description.

devinmcp_devin_session_interact#Interact with a Devin session — get status, send a message, sleep, or terminate.8 params▾

Interact with a Devin session — get status, send a message, sleep, or terminate.

NameTypeRequiredDescription

actionstringrequiredNo description.

session_idstringrequiredNo description.

afterstringoptionalNo description.

archive_on_terminatebooleanoptionalNo description.

attachment_urlsstringoptionalNo description.

firststringoptionalNo description.

messagestringoptionalNo description.

tagsstringoptionalNo description.

devinmcp_devin_session_search#Search and filter Devin sessions by date, tags, playbook, schedule, or user.13 params▾

Search and filter Devin sessions by date, tags, playbook, schedule, or user.

NameTypeRequiredDescription

afterstringoptionalNo description.

created_afterstringoptionalNo description.

created_beforestringoptionalNo description.

firststringoptionalNo description.

originsstringoptionalNo description.

parent_session_idstringoptionalNo description.

playbook_idstringoptionalNo description.

schedule_idstringoptionalNo description.

session_idsstringoptionalNo description.

tagsstringoptionalNo description.

updated_afterstringoptionalNo description.

updated_beforestringoptionalNo description.

user_idsstringoptionalNo description.

devinmcp_find_setting#Find a Devin webapp setting and get a deep-link URL to it.1 param▾

Find a Devin webapp setting and get a deep-link URL to it.

NameTypeRequiredDescription

querystringoptionalNo description.

devinmcp_generate_wiki#Generate a codebase wiki for a repository and wait for it to complete.1 param▾

Generate a codebase wiki for a repository and wait for it to complete.

NameTypeRequiredDescription

repoNamestringrequiredNo description.

devinmcp_list_available_repos#List all repositories available to query with your Devin account.0 params▾

List all repositories available to query with your Devin account.

devinmcp_list_integrations#List all native integrations and MCP servers for the organization with status and settings.1 param▾

List all native integrations and MCP servers for the organization with status and settings.

NameTypeRequiredDescription

filterstringoptionalNo description.

devinmcp_read_wiki_contents#View documentation content for a GitHub repository.1 param▾

View documentation content for a GitHub repository.

NameTypeRequiredDescription

repoNamestringrequiredNo description.

devinmcp_read_wiki_structure#Get a list of documentation topics for a GitHub repository.1 param▾

Get a list of documentation topics for a GitHub repository.

NameTypeRequiredDescription

repoNamestringrequiredNo description.