Read AI 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. Authorize and 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 = 'readaimcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Read AI MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'readaimcp_list_meetings',
     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 = "readaimcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Read AI MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="readaimcp_list_meetings",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Report share meeting — Share a Read AI meeting report with an email address on behalf of the authenticated user
• List meetings — List Read AI meetings for the authenticated user with optional start-time filters and cursor-based pagination
• Get meeting by id — Retrieve a single Read AI meeting by its ULID identifier, with optional expansion of rich meeting content such as summary, transcript, action items, topics, metrics, and recording download link
• Create meeting agent — Send a Read AI meeting agent (bot) to a video conferencing meeting to record and transcribe it

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.

readaimcp_create_meeting_agent#Send a Read AI meeting agent (bot) to a video conferencing meeting to record and transcribe it. Supports Zoom, Google Meet, and Microsoft Teams. The agent joins the meeting automatically and produces a recording, transcript, and AI-generated summary upon completion. When to use: Use this tool to dispatch a Read AI bot to an upcoming or in-progress meeting so it can record and transcribe the session. Provide either a meeting_url (simplest) or a meeting_platform + meeting_id combination. Use start_time to schedule the bot for a future meeting. When NOT to use: Do not use this tool to retrieve meeting content — use get_meeting_by_id or list_meetings instead. Do not use this tool for meetings on unsupported platforms.6 params▾

Send a Read AI meeting agent (bot) to a video conferencing meeting to record and transcribe it. Supports Zoom, Google Meet, and Microsoft Teams. The agent joins the meeting automatically and produces a recording, transcript, and AI-generated summary upon completion. When to use: Use this tool to dispatch a Read AI bot to an upcoming or in-progress meeting so it can record and transcribe the session. Provide either a meeting_url (simplest) or a meeting_platform + meeting_id combination. Use start_time to schedule the bot for a future meeting. When NOT to use: Do not use this tool to retrieve meeting content — use get_meeting_by_id or list_meetings instead. Do not use this tool for meetings on unsupported platforms.

NameTypeRequiredDescription

meeting_idstringoptionalThe platform-specific meeting identifier. Required unless meeting_url is provided.

meeting_passwordstringoptionalOptional meeting passcode/password if required to join.

meeting_platformstringoptionalThe video meeting platform (e.g. 'zoom', 'meet', 'teams'). Required unless meeting_url is provided.

meeting_urlstringoptionalOptional full meeting URL. When provided, meeting_platform and meeting_id are derived from the URL automatically.

start_timestringoptionalOptional start time in ISO 8601 format. If omitted, the agent joins the meeting immediately.

titlestringoptionalOptional title to stamp on the created meeting. If omitted, the meeting is given a generic platform-derived default (e.g. 'Zoom Meeting').

readaimcp_get_meeting_by_id#Retrieve a single Read AI meeting by its ULID identifier, with optional expansion of rich meeting content such as summary, transcript, action items, topics, metrics, and recording download link. When to use: Use this tool when you need full details about a specific meeting you already know the ID for — for example, to fetch the transcript, action items, or chapter summaries after a meeting completes. When NOT to use: Do not use this tool to search or browse meetings by date or keyword — use list_meetings instead.2 params▾

Retrieve a single Read AI meeting by its ULID identifier, with optional expansion of rich meeting content such as summary, transcript, action items, topics, metrics, and recording download link. When to use: Use this tool when you need full details about a specific meeting you already know the ID for — for example, to fetch the transcript, action items, or chapter summaries after a meeting completes. When NOT to use: Do not use this tool to search or browse meetings by date or keyword — use list_meetings instead.

NameTypeRequiredDescription

idstringrequiredMeeting ULID — the unique 26-character identifier for the meeting.

expandstringoptionalList of expandable fields to include in the response. When omitted, only base meeting metadata is returned.

readaimcp_list_meetings#List Read AI meetings for the authenticated user with optional start-time filters and cursor-based pagination. Returns up to 10 meetings per page. When to use: Use this tool to browse, search, or paginate through meetings — for example, to find all meetings within a date range, retrieve recent meetings, or iterate through all meetings using cursor-based pagination. When NOT to use: Do not use this tool when you already know the meeting ULID and need full content — use get_meeting_by_id instead.7 params▾

List Read AI meetings for the authenticated user with optional start-time filters and cursor-based pagination. Returns up to 10 meetings per page. When to use: Use this tool to browse, search, or paginate through meetings — for example, to find all meetings within a date range, retrieve recent meetings, or iterate through all meetings using cursor-based pagination. When NOT to use: Do not use this tool when you already know the meeting ULID and need full content — use get_meeting_by_id instead.

NameTypeRequiredDescription

cursorstringoptionalCursor for pagination. Pass the ULID of the last meeting from the previous page to retrieve the next page.

expandstringoptionalList of expandable fields to include in the response for each meeting. When omitted, only base metadata is returned.

limitintegeroptionalThe number of results to return per page. Maximum is 10.

start_datetime_gtstringoptionalOnly return meetings with start times strictly after this datetime (exclusive lower bound). ISO 8601 format.

start_datetime_gtestringoptionalOnly return meetings with start times on or after this datetime (inclusive lower bound). ISO 8601 format.

start_datetime_ltstringoptionalOnly return meetings with start times strictly before this datetime (exclusive upper bound). ISO 8601 format.

start_datetime_ltestringoptionalOnly return meetings with start times on or before this datetime (inclusive upper bound). ISO 8601 format.

readaimcp_share_meeting_report#Share a Read AI meeting report with an email address on behalf of the authenticated user. Grants the recipient access to the meeting at a specified access level and (optionally) emails them an invite. When to use: Call this tool when the user explicitly asks to share, send, give access to, or invite someone to a specific meeting report, identified by its ULID, and you have already confirmed (via get_meeting_by_id or list_meetings) that the user has "editor" or "owner" access to that meeting — only editors and owners are allowed to share. When NOT to use: Do not use this tool to share meetings the user does not have edit access to (if access_level is "viewer_full" or "viewer_recap_only", the call will fail). Do not use guessed or fabricated meeting IDs or email addresses. Do not use this tool to transfer ownership — ownership cannot be granted through this tool.5 params▾

Share a Read AI meeting report with an email address on behalf of the authenticated user. Grants the recipient access to the meeting at a specified access level and (optionally) emails them an invite. When to use: Call this tool when the user explicitly asks to share, send, give access to, or invite someone to a specific meeting report, identified by its ULID, and you have already confirmed (via get_meeting_by_id or list_meetings) that the user has "editor" or "owner" access to that meeting — only editors and owners are allowed to share. When NOT to use: Do not use this tool to share meetings the user does not have edit access to (if access_level is "viewer_full" or "viewer_recap_only", the call will fail). Do not use guessed or fabricated meeting IDs or email addresses. Do not use this tool to transfer ownership — ownership cannot be granted through this tool.

NameTypeRequiredDescription

emailstringrequiredEmail address to share the meeting report with. Must be a valid email address.

idstringrequiredMeeting ULID — the unique 26-character identifier for the meeting.

access_levelstringoptionalAccess level to grant the recipient: 'viewer_recap_only' (recap/summary only), 'viewer_full' (full read access), or 'editor' (read + edit). Ownership cannot be granted. Defaults to 'viewer_full'.

messagestringoptionalOptional personal message to include in the invite email. Only relevant when notify is true.

notifybooleanoptionalWhether to send the recipient an invite email notifying them of the shared report. Set to false to grant access silently without notifying them.