# Conductor — MCP server on mcp.ai
> Connect your Conductor account and use 17 tools for AI agents straight from your AI agent. Connect with your own API key. Conductor is a cloud development platform for creating workspaces, running coding-agent sessions, exchanging messages, and searching session transcripts.

By: mcp.ai · official
Page: https://mcp.ai/conductor

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_conductor?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/conductor/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/conductor/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/conductor/skill.md
Postman collection (v2.1): https://mcp.ai/conductor/postman.json

## Tools
- conductor_change_workspace_state(action: string, workspace_id: string) — Put a workspace to sleep or archive it. Both actions stop active workspace use; archive is a stronger transition but is documented as restorable. Confirm the intended target and state before calling.
- conductor_create_session(name?: string, agent: string, model?: string, effort?: string, channel?: string, fast_mode?: boolean, session_id?: string, workspace_id: string) — Create another agent chat session in an existing workspace. This may start agent/model resources and incur charges; call only when the user explicitly intends a new session.
- conductor_create_workspace(env?: object, name?: string, agent?: string, model?: string, branch?: string, effort?: string, channel?: string, project_id?: string, session_name?: string, repository_url?: string) — Create a cloud workspace and its first agent session. This launches compute and may incur cloud or model charges; call only when the user explicitly intends to create a new workspace.
- conductor_get_current_user() — Return the user and organization represented by the connected Conductor API key. Use this to verify which account the connection acts as.
- conductor_get_message(message_id: string) — Get one transcript message by id. The content may contain sensitive prompts, agent output, configuration, or provider-specific events.
- conductor_get_project(project_id: string) — Get one Conductor project and its repository remote by project id.
- conductor_get_session(channel?: string, session_id: string) — Get one agent session's configuration and current idle, working, or error status in one read. The tool fails unless both records are retrieved and refer to the requested session.
- conductor_get_workspace(channel?: string, workspace_id: string) — Get a workspace's metadata and current lifecycle status in one read, including initialization progress or errors. The tool fails unless both records are retrieved and refer to the requested workspace.
- conductor_list_messages(limit?: integer, offset?: integer, session_id: string, after_message_id?: string) — Read one page of a session transcript or incrementally read messages after a known message ID. Returned content may contain sensitive user prompts, agent output, configuration, or provider events; req
- conductor_list_projects(limit?: integer, offset?: integer) — List repositories available to the connected account for creating Conductor workspaces.
- conductor_list_sessions(limit?: integer, offset?: integer, channel?: string, workspace_id: string) — List one page of agent chat sessions in a Conductor workspace.
- conductor_list_workspaces(limit?: integer, offset?: integer, channel?: string, project_id: string) — List one page of workspaces belonging to a Conductor project, including deep links and recent activity.
- conductor_query_transcripts(query: string) — Run one read-only SQL SELECT against the organization's session_transcripts_view. Results can expose sensitive transcript text across many sessions: select only necessary columns, constrain rows with 
- conductor_rename_session(name: string, channel?: string, session_id: string) — Change an existing Conductor session's display name without stopping its agent.
- conductor_rename_workspace(name: string, channel?: string, workspace_id: string) — Change the display name of an existing Conductor workspace without changing its lifecycle state.
- conductor_send_message(message: string, message_id?: string, session_id: string) — Send a prompt to a Conductor session agent. This can start external agent/model execution and incur charges; it is not a passive transcript append. Call only when the user intends the agent to act.
- conductor_stop_session(action: string, session_id: string) — Cancel only the current turn and queued messages, or archive the entire session. Both can discard queued work; archive also stops the agent and leaves the session read-only. Confirm the intended actio

## Example prompts
- "What can I do in Conductor?"
- "Show me a summary of my Conductor account"

## Links
Docs: https://mcp.ai/docs/mcps/conductor
Website: https://mcp.ai/mcps/conductor