Skip to main content

​
Concept

MCP Servers (Model Context Protocol) are external servers that expose tools and resources so that Timely.ai agents can perform real-world actions during a conversation. Instead of the agent simply responding with text, it can use MCP tools to query a database, create a calendar event, look up an order in e-commerce, send an email, or any other action the MCP server supports. The MCP protocol is an open standard — any compatible server can be connected to a Timely agent. You can use publicly available community servers or develop your own to integrate your company’s internal systems.

​
How the Integration Works

customer sends message
    │
    ▼
AI agent processes and decides to use a tool
    │
    ▼
Timely.ai calls the MCP Server with the tool parameters
    │
    ▼
MCP Server executes the action and returns the result
    │
    ▼
agent incorporates the result into the response to the customer

​
MCP Server Lifecycle

add server (URL + configuration)
    │
    ▼
connect → Timely handshakes with the server
    │
    ▼
list available tools
    │
    ▼
activate specific tools on the agent
    │
    ├── sync tools (update list)
    │
    ├── deactivate specific tools
    │
    └── disconnect / delete

​
Main Fields

FieldTypeDescription
idstring (UUID)Unique MCP Server ID in the workspace
agent_idstring (UUID)Agent it is connected to
namestringDescriptive server name
urlstringMCP endpoint URL (SSE or HTTP)
transportenumsse | http
statusenumconnected | disconnected | error
auth_typeenumnone | bearer | api_key
auth_tokenstringAuthentication token (write-only)
tools_countnumberNumber of tools available on the server
active_toolsarrayList of slugs of tools activated on the agent
created_atstringISO 8601 timestamp when added to the workspace

​
Tool Fields

FieldTypeDescription
slugstringUnique tool identifier on the server
namestringHuman-readable tool name
descriptionstringWhat the tool does (used by the LLM to decide when to use it)
parametersobjectJSON Schema of the tool parameters
activebooleanWhether the tool is activated for the agent

​
Available Endpoints

See the left sidebar for the full list of endpoints in this group. Each endpoint has its own page with request/response schema, cURL/JS/Python examples, and an interactive playground.

​
Next Steps

Your first request

If you haven’t made your first call yet, start here.