Home / Servers / ElevenLabs API / get_conversation_histories_route
Get Conversations
An MCP tool from the ElevenLabs API server, hosted on mcp.hjlabs.in.
Get Conversations Get all conversations of agents that user owns. With option to restrict to a specific agent. [GET /v1/convai/conversations]
Name on the gateway: elevenlabs_api__get_conversation_histories_route · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
cursor | string | Used for fetching next page. Cursor is returned in the response. |
agent_id | string | Agent id (agent_…) or speech engine external id (seng_), resolved to the same… |
visited_agent_ids | array | Filter conversations where any of these agents participated. Can not exceed 50… |
visited_agent_branch_ids | array | Filter conversations where any of these agent branches participated. Can not… |
triggered_procedure_ids | array | Filter conversations where any of these procedures were triggered. Can not… |
call_successful | success | failure | unknown | error | The result of the success evaluation |
call_start_before_unix | integer | Unix timestamp (in seconds) to filter conversations up to this start date. |
call_start_after_unix | integer | Unix timestamp (in seconds) to filter conversations after to this start date. |
call_duration_min_secs | integer | Minimum call duration in seconds. |
call_duration_max_secs | integer | Maximum call duration in seconds. |
rating_max | integer | Maximum overall rating (1-5). |
rating_min | integer | Minimum overall rating (1-5). |
has_feedback_comment | boolean | Filter conversations with user feedback comments. |
user_id | string | Filter conversations by the user ID who initiated them. |
evaluation_params | array | Evaluation filters. Repeat param. Format: criteria_id:result where result is… |
data_collection_params | array | Data collection filters. Repeat param. Format: id:op:value where op is one of… |
dynamic_variable_params | array | Dynamic variable filters. Repeat param. Format: name:op:value where op is one… |
data_collection_filter | string | A single data collection filter, for callers that can only send one scalar… |
dynamic_variable_filter | string | A single dynamic variable filter, for callers that can only send one scalar… |
data_collection_ids | array | Data collection field IDs to include in each conversation summary. Repeat… |
evaluation_criteria_ids | array | Evaluation criteria IDs to include in each conversation summary. Repeat param.… |
tool_names | array | Filter conversations by tool names used during the call. |
tool_names_successful | array | Filter conversations by tool names that had successful calls. |
tool_names_errored | array | Filter conversations by tool names that had errored calls. |
include_invalid_tool_calls | boolean | Also match tool calls that never ran. |
main_languages | array | Filter conversations by detected main language (language code). |
page_size | integer | How many conversations to return at maximum. Can not exceed 100, defaults to 30. |
summary_mode | exclude | include | Whether to include transcript summaries in the response. |
search | string | Full-text or fuzzy search over transcript messages |
conversation_initiation_source | string | Enum representing the possible sources for conversation initiation. |
text_only | boolean | text_only parameter |
conversation_product_type | agents | speech_engine | Restrict results to a single conversation product surface. |
branch_id | string | Filter conversations by branch ID. |
version_id | string | Filter conversations by version ID. |
parent_conversation_id | string | Filter conversations by parent conversation ID for subagent conversations. |
topic_ids | array | Filter conversations by topic IDs assigned during topic discovery. |
exclude_statuses | array | Exclude conversations with the given statuses. Useful for hiding in-progress /… |
tag_ids | array | Filter conversations by conversation tag IDs assigned via the… |
workflow_node_entered_id | string | Filter conversations to only those that entered the given node. |
termination_reasons | array | Filter conversations by their stored termination_reason… |
guardrail_types | array | Filter to conversations where a guardrail of any of these types triggered… |
custom_guardrail_names | array | Filter to conversations where a custom guardrail with any of these names… |
sort_direction | asc | desc | The direction to sort conversations by call start time. Defaults to descending… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "elevenlabs_api__get_conversation_histories_route",
"arguments": {}
}Or connect the ElevenLabs API server directly, which lists 487 tools including this one:
claude mcp add --transport http hj-elevenlabs-api https://mcp.hjlabs.in/mcp/elevenlabs-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the get conversations tool with cursor set to ….