Devin MCP connector

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. Connect your Devin account

   Get your API key and create a connected account

   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:

• 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
• Interact devin session — Interact with a Devin session — get status, send a message, sleep, or terminate
• Gather devin session — Wait for multiple Devin sessions to reach a settled state before returning

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_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_playbook_manage#Manage Devin playbooks — list, get, create, or update playbook entries.8 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.

titlestringoptionalNo description.

devinmcp_devin_schedule_manage#Manage scheduled Devin sessions — list, get, create, update, or delete schedules.15 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.

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.7 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.

firststringoptionalNo description.

messagestringoptionalNo description.

tagsstringoptionalNo description.

devinmcp_devin_session_search#Search and filter Devin sessions by date, tags, playbook, schedule, or user.12 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.

playbook_idstringoptionalNo description.

schedule_idstringoptionalNo description.

session_idsstringoptionalNo description.

tagsstringoptionalNo description.

updated_afterstringoptionalNo description.

updated_beforestringoptionalNo description.

user_idsstringoptionalNo 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.