Integrates with .env files for configuration management, allowing users to set API credentials and configuration options through environment variables.
Enables JavaScript-based tool integration through the server, with support for TypeScript compilation and provides examples for connecting to the MCP server from a Claude.js client.
Provides tools for managing and configuring local sandboxes, including environment variable management, virtual environment recreation, and custom local sandbox configuration.
Provides an OpenAI-compatible interface through the /openai/v1/{agent_id}/chat/completions endpoint, allowing agents to be accessed via OpenAI SDK clients.
Supports TypeScript for implementing tools, with built-in compilation features and the ability to run TypeScript versions of the server directly.
openapi-mcp-server
Model Context Protocol (MCP) server for Letta API.
Description
This server provides a Model Context Protocol (MCP) interface to the API.
Installation
Install dependencies:
Create a
.envfile based on.env.example:
Edit the
.envfile to add your API configuration and authorization details.
Configuration
The following environment variables can be configured in the .env file:
API_BASE_URL: Base URL for the API (required)SERVER_NAME: Name of the MCP server (default: "openapi-mcp-server")SERVER_VERSION: Version of the MCP server (default: "1.0.0")DEBUG: Enable debug logging (true/false) (default: false)
Usage
Running the Server
The server is provided as both JavaScript and TypeScript versions:
Building the TypeScript Version
Using as an MCP Tool Provider
This server implements the Model Context Protocol (MCP) and can be used with any MCP-compatible consumer, like Claude.js client or other MCP consumers.
Example of connecting to this server from a Claude.js client:
Available Tools
This MCP server provides the following tools:
delete_tool
ID:
DELETE-v1-tools-tool-idDescription: Delete a tool by name
Method:
DELETEPath:
/v1/tools/{tool_id}
Parameters:
tool_id: tool_id parameter (required)user_id: user_id parameter
retrieve_tool
ID:
GET-v1-tools-tool-idDescription: Get a tool by ID
Method:
GETPath:
/v1/tools/{tool_id}
Parameters:
tool_id: tool_id parameter (required)user_id: user_id parameter
modify_tool
ID:
PATCH-v1-tools-tool-idDescription: Update an existing tool
Method:
PATCHPath:
/v1/tools/{tool_id}
Parameters:
tool_id: tool_id parameter (required)user_id: user_id parameter
list_tools
ID:
GET-v1-tools-Description: Get a list of all tools available to agents belonging to the org of the user
Method:
GETPath:
/v1/tools/
Parameters:
after: after parameterlimit: limit parametername: name parameteruser_id: user_id parameter
create_tool
ID:
POST-v1-tools-Description: Create a new tool
Method:
POSTPath:
/v1/tools/
Parameters:
user_id: user_id parameter
upsert_tool
ID:
PUT-v1-tools-Description: Create or update a tool
Method:
PUTPath:
/v1/tools/
Parameters:
user_id: user_id parameter
add_base_tools
ID:
POST-v1-tools-add-base-toolsDescription: Upsert base tools
Method:
POSTPath:
/v1/tools/add-base-tools
Parameters:
user_id: user_id parameter
run_tool_from_source
ID:
POST-v1-tools-runDescription: Attempt to build a tool from source, then run it on the provided arguments
Method:
POSTPath:
/v1/tools/run
Parameters:
user_id: user_id parameter
list_composio_apps
ID:
GET-v1-tools-composio-appsDescription: Get a list of all Composio apps
Method:
GETPath:
/v1/tools/composio/apps
Parameters:
user-id: user-id parameter
list_composio_actions_by_app
ID:
GET-v1-tools-composio-apps-composio-app-name-actionsDescription: Get a list of all Composio actions for a specific app
Method:
GETPath:
/v1/tools/composio/apps/{composio_app_name}/actions
Parameters:
composio_app_name: composio_app_name parameter (required)user_id: user_id parameter
add_composio_tool
ID:
POST-v1-tools-composio-composio-action-nameDescription: Add a new Composio tool by action name (Composio refers to each tool as an
Action)Method:
POSTPath:
/v1/tools/composio/{composio_action_name}
Parameters:
composio_action_name: composio_action_name parameter (required)user_id: user_id parameter
list_mcp_servers
ID:
GET-v1-tools-mcp-serversDescription: Get a list of all configured MCP servers
Method:
GETPath:
/v1/tools/mcp/servers
Parameters:
user-id: user-id parameter
add_mcp_server
ID:
PUT-v1-tools-mcp-serversDescription: Add a new MCP server to the Letta MCP server config
Method:
PUTPath:
/v1/tools/mcp/servers
Parameters:
user_id: user_id parameter
list_mcp_tools_by_server
ID:
GET-v1-tools-mcp-servers-mcp-server-name-toolsDescription: Get a list of all tools for a specific MCP server
Method:
GETPath:
/v1/tools/mcp/servers/{mcp_server_name}/tools
Parameters:
mcp_server_name: mcp_server_name parameter (required)user_id: user_id parameter
add_mcp_tool
ID:
POST-v1-tools-mcp-servers-mcp-server-name-mcp-tool-nameDescription: Register a new MCP tool as a Letta server by MCP server + tool name
Method:
POSTPath:
/v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}
Parameters:
mcp_server_name: mcp_server_name parameter (required)mcp_tool_name: mcp_tool_name parameter (required)user_id: user_id parameter
delete_mcp_server
ID:
DELETE-v1-tools-mcp-servers-mcp-server-nameDescription: Add a new MCP server to the Letta MCP server config
Method:
DELETEPath:
/v1/tools/mcp/servers/{mcp_server_name}
Parameters:
mcp_server_name: mcp_server_name parameter (required)user_id: user_id parameter
retrieve_source
ID:
GET-v1-sources-source-idDescription: Get all sources
Method:
GETPath:
/v1/sources/{source_id}
Parameters:
source_id: source_id parameter (required)user_id: user_id parameter
modify_source
ID:
PATCH-v1-sources-source-idDescription: Update the name or documentation of an existing data source.
Method:
PATCHPath:
/v1/sources/{source_id}
Parameters:
source_id: source_id parameter (required)user_id: user_id parameter
delete_source
ID:
DELETE-v1-sources-source-idDescription: Delete a data source.
Method:
DELETEPath:
/v1/sources/{source_id}
Parameters:
source_id: source_id parameter (required)user_id: user_id parameter
get_source_id_by_name
ID:
GET-v1-sources-name-source-nameDescription: Get a source by name
Method:
GETPath:
/v1/sources/name/{source_name}
Parameters:
source_name: source_name parameter (required)user_id: user_id parameter
list_sources
ID:
GET-v1-sources-Description: List all data sources created by a user.
Method:
GETPath:
/v1/sources/
Parameters:
user_id: user_id parameter
create_source
ID:
POST-v1-sources-Description: Create a new data source.
Method:
POSTPath:
/v1/sources/
Parameters:
user_id: user_id parameter
upload_file_to_source
ID:
POST-v1-sources-source-id-uploadDescription: Upload a file to a data source.
Method:
POSTPath:
/v1/sources/{source_id}/upload
Parameters:
source_id: source_id parameter (required)user_id: user_id parameter
list_source_passages
ID:
GET-v1-sources-source-id-passagesDescription: List all passages associated with a data source.
Method:
GETPath:
/v1/sources/{source_id}/passages
Parameters:
source_id: source_id parameter (required)user_id: user_id parameter
list_source_files
ID:
GET-v1-sources-source-id-filesDescription: List paginated files associated with a data source.
Method:
GETPath:
/v1/sources/{source_id}/files
Parameters:
source_id: source_id parameter (required)limit: Number of files to returnafter: Pagination cursor to fetch the next set of resultsuser_id: user_id parameter
delete_file_from_source
ID:
DELETE-v1-sources-source-id-file-idDescription: Delete a data source.
Method:
DELETEPath:
/v1/sources/{source_id}/{file_id}
Parameters:
source_id: source_id parameter (required)file_id: file_id parameter (required)user_id: user_id parameter
list_agents
ID:
GET-v1-agents-Description: List all agents associated with a given user.
This endpoint retrieves a list of all agents and their configurations associated with the specified user ID.
Method:
GETPath:
/v1/agents/
Parameters:
name: Name of the agenttags: List of tags to filter agents bymatch_all_tags: If True, only returns agents that match ALL given tags. Otherwise, return agents that have ANY of the passed-in tags.before: Cursor for paginationafter: Cursor for paginationlimit: Limit for paginationquery_text: Search agents by nameproject_id: Search agents by project IDtemplate_id: Search agents by template IDbase_template_id: Search agents by base template IDidentity_id: Search agents by identity IDidentifier_keys: Search agents by identifier keysinclude_relationships: Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include in the response. If not provided, all relationships are loaded by default. Using this can optimize performance by reducing unnecessary joins.ascending: Whether to sort agents oldest to newest (True) or newest to oldest (False, default)user_id: user_id parameter
create_agent
ID:
POST-v1-agents-Description: Create a new agent with the specified configuration.
Method:
POSTPath:
/v1/agents/
Parameters:
user_id: user_id parameterX-Project: X-Project parameter
export_agent_serialized
ID:
GET-v1-agents-agent-id-exportDescription: Export the serialized JSON representation of an agent.
Method:
GETPath:
/v1/agents/{agent_id}/export
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
import_agent_serialized
ID:
POST-v1-agents-importDescription: Import a serialized agent file and recreate the agent in the system.
Method:
POSTPath:
/v1/agents/import
Parameters:
append_copy_suffix: If set to True, appends "_copy" to the end of the agent name.override_existing_tools: If set to True, existing tools can get their source code overwritten by the uploaded tool definitions. Note that Letta core tools can never be updated externally.project_id: The project ID to associate the uploaded agent with.user_id: user_id parameter
retrieve_agent_context_window
ID:
GET-v1-agents-agent-id-contextDescription: Retrieve the context window of a specific agent.
Method:
GETPath:
/v1/agents/{agent_id}/context
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
modify_agent
ID:
PATCH-v1-agents-agent-idDescription: Update an existing agent
Method:
PATCHPath:
/v1/agents/{agent_id}
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
retrieve_agent
ID:
GET-v1-agents-agent-idDescription: Get the state of the agent.
Method:
GETPath:
/v1/agents/{agent_id}
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
delete_agent
ID:
DELETE-v1-agents-agent-idDescription: Delete an agent.
Method:
DELETEPath:
/v1/agents/{agent_id}
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
list_agent_tools
ID:
GET-v1-agents-agent-id-toolsDescription: Get tools from an existing agent
Method:
GETPath:
/v1/agents/{agent_id}/tools
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
attach_tool
ID:
PATCH-v1-agents-agent-id-tools-attach-tool-idDescription: Attach a tool to an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/tools/attach/{tool_id}
Parameters:
agent_id: agent_id parameter (required)tool_id: tool_id parameter (required)user_id: user_id parameter
detach_tool
ID:
PATCH-v1-agents-agent-id-tools-detach-tool-idDescription: Detach a tool from an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/tools/detach/{tool_id}
Parameters:
agent_id: agent_id parameter (required)tool_id: tool_id parameter (required)user_id: user_id parameter
attach_source_to_agent
ID:
PATCH-v1-agents-agent-id-sources-attach-source-idDescription: Attach a source to an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/sources/attach/{source_id}
Parameters:
agent_id: agent_id parameter (required)source_id: source_id parameter (required)user_id: user_id parameter
detach_source_from_agent
ID:
PATCH-v1-agents-agent-id-sources-detach-source-idDescription: Detach a source from an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/sources/detach/{source_id}
Parameters:
agent_id: agent_id parameter (required)source_id: source_id parameter (required)user_id: user_id parameter
list_agent_sources
ID:
GET-v1-agents-agent-id-sourcesDescription: Get the sources associated with an agent.
Method:
GETPath:
/v1/agents/{agent_id}/sources
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
retrieve_agent_memory
ID:
GET-v1-agents-agent-id-core-memoryDescription: Retrieve the memory state of a specific agent. This endpoint fetches the current memory state of the agent identified by the user ID and agent ID.
Method:
GETPath:
/v1/agents/{agent_id}/core-memory
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
retrieve_core_memory_block
ID:
GET-v1-agents-agent-id-core-memory-blocks-block-labelDescription: Retrieve a core memory block from an agent.
Method:
GETPath:
/v1/agents/{agent_id}/core-memory/blocks/{block_label}
Parameters:
agent_id: agent_id parameter (required)block_label: block_label parameter (required)user_id: user_id parameter
modify_core_memory_block
ID:
PATCH-v1-agents-agent-id-core-memory-blocks-block-labelDescription: Updates a core memory block of an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/core-memory/blocks/{block_label}
Parameters:
agent_id: agent_id parameter (required)block_label: block_label parameter (required)user_id: user_id parameter
list_core_memory_blocks
ID:
GET-v1-agents-agent-id-core-memory-blocksDescription: Retrieve the core memory blocks of a specific agent.
Method:
GETPath:
/v1/agents/{agent_id}/core-memory/blocks
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
attach_core_memory_block
ID:
PATCH-v1-agents-agent-id-core-memory-blocks-attach-block-idDescription: Attach a core memoryblock to an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}
Parameters:
agent_id: agent_id parameter (required)block_id: block_id parameter (required)user_id: user_id parameter
detach_core_memory_block
ID:
PATCH-v1-agents-agent-id-core-memory-blocks-detach-block-idDescription: Detach a core memory block from an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}
Parameters:
agent_id: agent_id parameter (required)block_id: block_id parameter (required)user_id: user_id parameter
list_passages
ID:
GET-v1-agents-agent-id-archival-memoryDescription: Retrieve the memories in an agent's archival memory store (paginated query).
Method:
GETPath:
/v1/agents/{agent_id}/archival-memory
Parameters:
agent_id: agent_id parameter (required)after: Unique ID of the memory to start the query range at.before: Unique ID of the memory to end the query range at.limit: How many results to include in the response.search: Search passages by textascending: Whether to sort passages oldest to newest (True, default) or newest to oldest (False)user_id: user_id parameter
create_passage
ID:
POST-v1-agents-agent-id-archival-memoryDescription: Insert a memory into an agent's archival memory store.
Method:
POSTPath:
/v1/agents/{agent_id}/archival-memory
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
modify_passage
ID:
PATCH-v1-agents-agent-id-archival-memory-memory-idDescription: Modify a memory in the agent's archival memory store.
Method:
PATCHPath:
/v1/agents/{agent_id}/archival-memory/{memory_id}
Parameters:
agent_id: agent_id parameter (required)memory_id: memory_id parameter (required)user_id: user_id parameter
delete_passage
ID:
DELETE-v1-agents-agent-id-archival-memory-memory-idDescription: Delete a memory from an agent's archival memory store.
Method:
DELETEPath:
/v1/agents/{agent_id}/archival-memory/{memory_id}
Parameters:
agent_id: agent_id parameter (required)memory_id: memory_id parameter (required)user_id: user_id parameter
list_messages
ID:
GET-v1-agents-agent-id-messagesDescription: Retrieve message history for an agent.
Method:
GETPath:
/v1/agents/{agent_id}/messages
Parameters:
agent_id: agent_id parameter (required)after: Message after which to retrieve the returned messages.before: Message before which to retrieve the returned messages.limit: Maximum number of messages to retrieve.use_assistant_message: Whether to use assistant messagesassistant_message_tool_name: The name of the designated message tool.assistant_message_tool_kwarg: The name of the message argument.user_id: user_id parameter
send_message
ID:
POST-v1-agents-agent-id-messagesDescription: Process a user message and return the agent's response. This endpoint accepts a message from a user and processes it through the agent.
Method:
POSTPath:
/v1/agents/{agent_id}/messages
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
modify_message
ID:
PATCH-v1-agents-agent-id-messages-message-idDescription: Update the details of a message associated with an agent.
Method:
PATCHPath:
/v1/agents/{agent_id}/messages/{message_id}
Parameters:
agent_id: agent_id parameter (required)message_id: message_id parameter (required)user_id: user_id parameter
create_agent_message_stream
ID:
POST-v1-agents-agent-id-messages-streamDescription: Process a user message and return the agent's response. This endpoint accepts a message from a user and processes it through the agent. It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.
Method:
POSTPath:
/v1/agents/{agent_id}/messages/stream
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
create_agent_message_async
ID:
POST-v1-agents-agent-id-messages-asyncDescription: Asynchronously process a user message and return a run object. The actual processing happens in the background, and the status can be checked using the run ID.
Method:
POSTPath:
/v1/agents/{agent_id}/messages/async
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
reset_messages
ID:
PATCH-v1-agents-agent-id-reset-messagesDescription: Resets the messages for an agent
Method:
PATCHPath:
/v1/agents/{agent_id}/reset-messages
Parameters:
agent_id: agent_id parameter (required)add_default_initial_messages: If true, adds the default initial messages after resetting.user_id: user_id parameter
create_group
ID:
POST-v1-groups-Description: Create a new multi-agent group with the specified configuration.
Method:
POSTPath:
/v1/groups/
Parameters:
user_id: user_id parameterX-Project: X-Project parameter
list_groups
ID:
GET-v1-groups-Description: Fetch all multi-agent groups matching query.
Method:
GETPath:
/v1/groups/
Parameters:
manager_type: Search groups by manager typebefore: Cursor for paginationafter: Cursor for paginationlimit: Limit for paginationproject_id: Search groups by project iduser_id: user_id parameter
upsert_group
ID:
PUT-v1-groups-Description: Create a new multi-agent group with the specified configuration.
Method:
PUTPath:
/v1/groups/
Parameters:
user_id: user_id parameterX-Project: X-Project parameter
delete_group
ID:
DELETE-v1-groups-group-idDescription: Delete a multi-agent group.
Method:
DELETEPath:
/v1/groups/{group_id}
Parameters:
group_id: group_id parameter (required)user_id: user_id parameter
send_group_message
ID:
POST-v1-groups-group-id-messagesDescription: Process a user message and return the group's response. This endpoint accepts a message from a user and processes it through through agents in the group based on the specified pattern
Method:
POSTPath:
/v1/groups/{group_id}/messages
Parameters:
agent_id: agent_id parameter (required)user_id: user_id parameter
list_group_messages
ID:
GET-v1-groups-group-id-messagesDescription: Retrieve message history for an agent.
Method:
GETPath:
/v1/groups/{group_id}/messages
Parameters:
group_id: group_id parameter (required)after: Message after which to retrieve the returned messages.before: Message before which to retrieve the returned messages.limit: Maximum number of messages to retrieve.use_assistant_message: Whether to use assistant messagesassistant_message_tool_name: The name of the designated message tool.assistant_message_tool_kwarg: The name of the message argument.user_id: user_id parameter
send_group_message_streaming
ID:
POST-v1-groups-group-id-messages-streamDescription: Process a user message and return the group's responses. This endpoint accepts a message from a user and processes it through agents in the group based on the specified pattern. It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.
Method:
POSTPath:
/v1/groups/{group_id}/messages/stream
Parameters:
group_id: group_id parameter (required)user_id: user_id parameter
list_identities
ID:
GET-v1-identities-Description: Get a list of all identities in the database
Method:
GETPath:
/v1/identities/
Parameters:
name: name parameterproject_id: project_id parameteridentifier_key: identifier_key parameteridentity_type: identity_type parameterbefore: before parameterafter: after parameterlimit: limit parameteruser_id: user_id parameter
create_identity
ID:
POST-v1-identities-Description: Make a POST request to /v1/identities/
Method:
POSTPath:
/v1/identities/
Parameters:
user_id: user_id parameterX-Project: X-Project parameter
upsert_identity
ID:
PUT-v1-identities-Description: Make a PUT request to /v1/identities/
Method:
PUTPath:
/v1/identities/
Parameters:
user_id: user_id parameterX-Project: X-Project parameter
retrieve_identity
ID:
GET-v1-identities-identity-idDescription: Make a GET request to /v1/identities/{identity_id}
Method:
GETPath:
/v1/identities/{identity_id}
Parameters:
identity_id: identity_id parameter (required)user_id: user_id parameter
update_identity
ID:
PATCH-v1-identities-identity-idDescription: Make a PATCH request to /v1/identities/{identity_id}
Method:
PATCHPath:
/v1/identities/{identity_id}
Parameters:
identity_id: identity_id parameter (required)user_id: user_id parameter
delete_identity
ID:
DELETE-v1-identities-identity-idDescription: Delete an identity by its identifier key
Method:
DELETEPath:
/v1/identities/{identity_id}
Parameters:
identity_id: identity_id parameter (required)user_id: user_id parameter
list_models
ID:
GET-v1-models-Description: Make a GET request to /v1/models/
Method:
GETPath:
/v1/models/
No parameters required.
list_embedding_models
ID:
GET-v1-models-embeddingDescription: Make a GET request to /v1/models/embedding
Method:
GETPath:
/v1/models/embedding
No parameters required.
list_blocks
ID:
GET-v1-blocks-Description: Make a GET request to /v1/blocks/
Method:
GETPath:
/v1/blocks/
Parameters:
label: Labels to include (e.g. human, persona)templates_only: Whether to include only templatesname: Name of the blockidentity_id: Search agents by identifier ididentifier_keys: Search agents by identifier keysuser_id: user_id parameter
create_block
ID:
POST-v1-blocks-Description: Make a POST request to /v1/blocks/
Method:
POSTPath:
/v1/blocks/
Parameters:
user_id: user_id parameter
modify_block
ID:
PATCH-v1-blocks-block-idDescription: Make a PATCH request to /v1/blocks/{block_id}
Method:
PATCHPath:
/v1/blocks/{block_id}
Parameters:
block_id: block_id parameter (required)user_id: user_id parameter
delete_block
ID:
DELETE-v1-blocks-block-idDescription: Make a DELETE request to /v1/blocks/{block_id}
Method:
DELETEPath:
/v1/blocks/{block_id}
Parameters:
block_id: block_id parameter (required)user_id: user_id parameter
retrieve_block
ID:
GET-v1-blocks-block-idDescription: Make a GET request to /v1/blocks/{block_id}
Method:
GETPath:
/v1/blocks/{block_id}
Parameters:
block_id: block_id parameter (required)user_id: user_id parameter
list_agents_for_block
ID:
GET-v1-blocks-block-id-agentsDescription: Retrieves all agents associated with the specified block. Raises a 404 if the block does not exist.
Method:
GETPath:
/v1/blocks/{block_id}/agents
Parameters:
block_id: block_id parameter (required)user_id: user_id parameter
list_jobs
ID:
GET-v1-jobs-Description: List all jobs.
Method:
GETPath:
/v1/jobs/
Parameters:
source_id: Only list jobs associated with the source.user_id: user_id parameter
list_active_jobs
ID:
GET-v1-jobs-activeDescription: List all active jobs.
Method:
GETPath:
/v1/jobs/active
Parameters:
user_id: user_id parameter
retrieve_job
ID:
GET-v1-jobs-job-idDescription: Get the status of a job.
Method:
GETPath:
/v1/jobs/{job_id}
Parameters:
job_id: job_id parameter (required)user_id: user_id parameter
delete_job
ID:
DELETE-v1-jobs-job-idDescription: Delete a job by its job_id.
Method:
DELETEPath:
/v1/jobs/{job_id}
Parameters:
job_id: job_id parameter (required)user_id: user_id parameter
health_check
ID:
GET-v1-health-Description: Make a GET request to /v1/health/
Method:
GETPath:
/v1/health/
No parameters required.
create_sandbox_config_v1_sandbox_config__post
ID:
POST-v1-sandbox-config-Description: Make a POST request to /v1/sandbox-config/
Method:
POSTPath:
/v1/sandbox-config/
Parameters:
user-id: user-id parameter
list_sandbox_configs_v1_sandbox_config__get
ID:
GET-v1-sandbox-config-Description: Make a GET request to /v1/sandbox-config/
Method:
GETPath:
/v1/sandbox-config/
Parameters:
limit: Number of results to returnafter: Pagination cursor to fetch the next set of resultssandbox_type: Filter for this specific sandbox typeuser-id: user-id parameter
create_default_e2b_sandbox_config_v1_sandbox_config_e2b_default_post
ID:
POST-v1-sandbox-config-e2b-defaultDescription: Make a POST request to /v1/sandbox-config/e2b/default
Method:
POSTPath:
/v1/sandbox-config/e2b/default
Parameters:
user-id: user-id parameter
create_default_local_sandbox_config_v1_sandbox_config_local_default_post
ID:
POST-v1-sandbox-config-local-defaultDescription: Make a POST request to /v1/sandbox-config/local/default
Method:
POSTPath:
/v1/sandbox-config/local/default
Parameters:
user-id: user-id parameter
create_custom_local_sandbox_config_v1_sandbox_config_local_post
ID:
POST-v1-sandbox-config-localDescription: Create or update a custom LocalSandboxConfig, including pip_requirements.
Method:
POSTPath:
/v1/sandbox-config/local
Parameters:
user-id: user-id parameter
update_sandbox_config_v1_sandbox_config__sandbox_config_id__patch
ID:
PATCH-v1-sandbox-config-sandbox-config-idDescription: Make a PATCH request to /v1/sandbox-config/{sandbox_config_id}
Method:
PATCHPath:
/v1/sandbox-config/{sandbox_config_id}
Parameters:
sandbox_config_id: sandbox_config_id parameter (required)user-id: user-id parameter
delete_sandbox_config_v1_sandbox_config__sandbox_config_id__delete
ID:
DELETE-v1-sandbox-config-sandbox-config-idDescription: Make a DELETE request to /v1/sandbox-config/{sandbox_config_id}
Method:
DELETEPath:
/v1/sandbox-config/{sandbox_config_id}
Parameters:
sandbox_config_id: sandbox_config_id parameter (required)user-id: user-id parameter
force_recreate_local_sandbox_venv_v1_sandbox_config_local_recreate_venv_post
ID:
POST-v1-sandbox-config-local-recreate-venvDescription: Forcefully recreate the virtual environment for the local sandbox. Deletes and recreates the venv, then reinstalls required dependencies.
Method:
POSTPath:
/v1/sandbox-config/local/recreate-venv
Parameters:
user-id: user-id parameter
create_sandbox_env_var_v1_sandbox_config__sandbox_config_id__environment_variable_post
ID:
POST-v1-sandbox-config-sandbox-config-id-environment-variableDescription: Make a POST request to /v1/sandbox-config/{sandbox_config_id}/environment-variable
Method:
POSTPath:
/v1/sandbox-config/{sandbox_config_id}/environment-variable
Parameters:
sandbox_config_id: sandbox_config_id parameter (required)user-id: user-id parameter
list_sandbox_env_vars_v1_sandbox_config__sandbox_config_id__environment_variable_get
ID:
GET-v1-sandbox-config-sandbox-config-id-environment-variableDescription: Make a GET request to /v1/sandbox-config/{sandbox_config_id}/environment-variable
Method:
GETPath:
/v1/sandbox-config/{sandbox_config_id}/environment-variable
Parameters:
sandbox_config_id: sandbox_config_id parameter (required)limit: Number of results to returnafter: Pagination cursor to fetch the next set of resultsuser-id: user-id parameter
update_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__patch
ID:
PATCH-v1-sandbox-config-environment-variable-env-var-idDescription: Make a PATCH request to /v1/sandbox-config/environment-variable/{env_var_id}
Method:
PATCHPath:
/v1/sandbox-config/environment-variable/{env_var_id}
Parameters:
env_var_id: env_var_id parameter (required)user-id: user-id parameter
delete_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__delete
ID:
DELETE-v1-sandbox-config-environment-variable-env-var-idDescription: Make a DELETE request to /v1/sandbox-config/environment-variable/{env_var_id}
Method:
DELETEPath:
/v1/sandbox-config/environment-variable/{env_var_id}
Parameters:
env_var_id: env_var_id parameter (required)user-id: user-id parameter
list_providers
ID:
GET-v1-providers-Description: Get a list of all custom providers in the database
Method:
GETPath:
/v1/providers/
Parameters:
after: after parameterlimit: limit parameteruser_id: user_id parameter
create_provider
ID:
POST-v1-providers-Description: Create a new custom provider
Method:
POSTPath:
/v1/providers/
Parameters:
user_id: user_id parameter
modify_provider
ID:
PATCH-v1-providers-Description: Update an existing custom provider
Method:
PATCHPath:
/v1/providers/
Parameters:
user_id: user_id parameter
delete_provider
ID:
DELETE-v1-providers-Description: Delete an existing custom provider
Method:
DELETEPath:
/v1/providers/
Parameters:
provider_id: The provider_id key to be deleted. (required)user_id: user_id parameter
list_runs
ID:
GET-v1-runs-Description: List all runs.
Method:
GETPath:
/v1/runs/
Parameters:
user_id: user_id parameter
list_active_runs
ID:
GET-v1-runs-activeDescription: List all active runs.
Method:
GETPath:
/v1/runs/active
Parameters:
user_id: user_id parameter
retrieve_run
ID:
GET-v1-runs-run-idDescription: Get the status of a run.
Method:
GETPath:
/v1/runs/{run_id}
Parameters:
run_id: run_id parameter (required)user_id: user_id parameter
delete_run
ID:
DELETE-v1-runs-run-idDescription: Delete a run by its run_id.
Method:
DELETEPath:
/v1/runs/{run_id}
Parameters:
run_id: run_id parameter (required)user_id: user_id parameter
list_run_messages
ID:
GET-v1-runs-run-id-messagesDescription: Get messages associated with a run with filtering options.
Args:
run_id: ID of the run
before: A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
after: A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
limit: Maximum number of messages to return
order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
role: Filter by role (user/assistant/system/tool)
return_message_object: Whether to return Message objects or LettaMessage objects
user_id: ID of the user making the request
Returns: A list of messages associated with the run. Default is List[LettaMessage].
Method:
GETPath:
/v1/runs/{run_id}/messages
Parameters:
run_id: run_id parameter (required)before: Cursor for paginationafter: Cursor for paginationlimit: Maximum number of messages to returnorder: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.role: Filter by roleuser_id: user_id parameter
retrieve_run_usage
ID:
GET-v1-runs-run-id-usageDescription: Get usage statistics for a run.
Method:
GETPath:
/v1/runs/{run_id}/usage
Parameters:
run_id: run_id parameter (required)user_id: user_id parameter
list_run_steps
ID:
GET-v1-runs-run-id-stepsDescription: Get messages associated with a run with filtering options.
Args:
run_id: ID of the run
before: A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
after: A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
limit: Maximum number of steps to return
order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
Returns: A list of steps associated with the run.
Method:
GETPath:
/v1/runs/{run_id}/steps
Parameters:
run_id: run_id parameter (required)before: Cursor for paginationafter: Cursor for paginationlimit: Maximum number of messages to returnorder: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.user_id: user_id parameter
list_steps
ID:
GET-v1-stepsDescription: List steps with optional pagination and date filters. Dates should be provided in ISO 8601 format (e.g. 2025-01-29T15:01:19-08:00)
Method:
GETPath:
/v1/steps
Parameters:
before: Return steps before this step IDafter: Return steps after this step IDlimit: Maximum number of steps to returnorder: Sort order (asc or desc)start_date: Return steps after this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")end_date: Return steps before this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")model: Filter by the name of the model used for the stepagent_id: Filter by the ID of the agent that performed the stepuser_id: user_id parameter
retrieve_step
ID:
GET-v1-steps-step-idDescription: Get a step by ID.
Method:
GETPath:
/v1/steps/{step_id}
Parameters:
step_id: step_id parameter (required)user_id: user_id parameter
update_step_transaction_id
ID:
PATCH-v1-steps-step-id-transaction-transaction-idDescription: Update the transaction ID for a step.
Method:
PATCHPath:
/v1/steps/{step_id}/transaction/{transaction_id}
Parameters:
step_id: step_id parameter (required)transaction_id: transaction_id parameter (required)user_id: user_id parameter
list_tags
ID:
GET-v1-tags-Description: Get a list of all tags in the database
Method:
GETPath:
/v1/tags/
Parameters:
after: after parameterlimit: limit parameterquery_text: query_text parameteruser_id: user_id parameter
create_voice_chat_completions
ID:
POST-v1-voice-beta-agent-id-chat-completionsDescription: Make a POST request to /v1/voice-beta/{agent_id}/chat/completions
Method:
POSTPath:
/v1/voice-beta/{agent_id}/chat/completions
Parameters:
agent_id: agent_id parameter (required)user-id: user-id parameter
list_users
ID:
GET-v1-admin-users-Description: Get a list of all users in the database
Method:
GETPath:
/v1/admin/users/
Parameters:
after: after parameterlimit: limit parameter
create_user
ID:
POST-v1-admin-users-Description: Create a new user in the database
Method:
POSTPath:
/v1/admin/users/
No parameters required.
update_user
ID:
PUT-v1-admin-users-Description: Update a user in the database
Method:
PUTPath:
/v1/admin/users/
No parameters required.
delete_user
ID:
DELETE-v1-admin-users-Description: Make a DELETE request to /v1/admin/users/
Method:
DELETEPath:
/v1/admin/users/
Parameters:
user_id: The user_id key to be deleted. (required)
list_orgs
ID:
GET-v1-admin-orgs-Description: Get a list of all orgs in the database
Method:
GETPath:
/v1/admin/orgs/
Parameters:
after: after parameterlimit: limit parameter
create_organization
ID:
POST-v1-admin-orgs-Description: Create a new org in the database
Method:
POSTPath:
/v1/admin/orgs/
No parameters required.
delete_organization_by_id
ID:
DELETE-v1-admin-orgs-Description: Make a DELETE request to /v1/admin/orgs/
Method:
DELETEPath:
/v1/admin/orgs/
Parameters:
org_id: The org_id key to be deleted. (required)
update_organization
ID:
PATCH-v1-admin-orgs-Description: Make a PATCH request to /v1/admin/orgs/
Method:
PATCHPath:
/v1/admin/orgs/
Parameters:
org_id: The org_id key to be updated. (required)
create_chat_completions
ID:
POST-openai-v1-agent-id-chat-completionsDescription: Make a POST request to /openai/v1/{agent_id}/chat/completions
Method:
POSTPath:
/openai/v1/{agent_id}/chat/completions
Parameters:
agent_id: agent_id parameter (required)user-id: user-id parameter
authenticate_user_v1_auth_post
ID:
POST-v1-authDescription: Authenticates the user and sends response with User related data.
Currently, this is a placeholder that simply returns a UUID placeholder
Method:
POSTPath:
/v1/auth
No parameters required.
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Control AI agents creation and modification via MCP.
- Description
- Installation
- Configuration
- Usage
- Using as an MCP Tool Provider
- Available Tools
- delete_tool
- retrieve_tool
- modify_tool
- list_tools
- create_tool
- upsert_tool
- add_base_tools
- run_tool_from_source
- list_composio_apps
- list_composio_actions_by_app
- add_composio_tool
- list_mcp_servers
- add_mcp_server
- list_mcp_tools_by_server
- add_mcp_tool
- delete_mcp_server
- retrieve_source
- modify_source
- delete_source
- get_source_id_by_name
- list_sources
- create_source
- upload_file_to_source
- list_source_passages
- list_source_files
- delete_file_from_source
- list_agents
- create_agent
- export_agent_serialized
- import_agent_serialized
- retrieve_agent_context_window
- modify_agent
- retrieve_agent
- delete_agent
- list_agent_tools
- attach_tool
- detach_tool
- attach_source_to_agent
- detach_source_from_agent
- list_agent_sources
- retrieve_agent_memory
- retrieve_core_memory_block
- modify_core_memory_block
- list_core_memory_blocks
- attach_core_memory_block
- detach_core_memory_block
- list_passages
- create_passage
- modify_passage
- delete_passage
- list_messages
- send_message
- modify_message
- create_agent_message_stream
- create_agent_message_async
- reset_messages
- create_group
- list_groups
- upsert_group
- delete_group
- send_group_message
- list_group_messages
- send_group_message_streaming
- list_identities
- create_identity
- upsert_identity
- retrieve_identity
- update_identity
- delete_identity
- list_models
- list_embedding_models
- list_blocks
- create_block
- modify_block
- delete_block
- retrieve_block
- list_agents_for_block
- list_jobs
- list_active_jobs
- retrieve_job
- delete_job
- health_check
- create_sandbox_config_v1_sandbox_config__post
- list_sandbox_configs_v1_sandbox_config__get
- create_default_e2b_sandbox_config_v1_sandbox_config_e2b_default_post
- create_default_local_sandbox_config_v1_sandbox_config_local_default_post
- create_custom_local_sandbox_config_v1_sandbox_config_local_post
- update_sandbox_config_v1_sandbox_config__sandbox_config_id__patch
- delete_sandbox_config_v1_sandbox_config__sandbox_config_id__delete
- force_recreate_local_sandbox_venv_v1_sandbox_config_local_recreate_venv_post
- create_sandbox_env_var_v1_sandbox_config__sandbox_config_id__environment_variable_post
- list_sandbox_env_vars_v1_sandbox_config__sandbox_config_id__environment_variable_get
- update_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__patch
- delete_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__delete
- list_providers
- create_provider
- modify_provider
- delete_provider
- list_runs
- list_active_runs
- retrieve_run
- delete_run
- list_run_messages
- retrieve_run_usage
- list_run_steps
- list_steps
- retrieve_step
- update_step_transaction_id
- list_tags
- create_voice_chat_completions
- list_users
- create_user
- update_user
- delete_user
- list_orgs
- create_organization
- delete_organization_by_id
- update_organization
- create_chat_completions
- authenticate_user_v1_auth_post
- License
Related MCP Servers
- -securityAlicense-qualityAn MCP server that bridges AI agents with GUI automation capabilities, allowing them to control mouse, keyboard, windows, and take screenshots to interact with desktop applications.Last updated -10MIT License
- -securityFlicense-qualityZero Trust Access AI Agent - MCP ServerLast updated -1
- GoMIT License
- MIT License