# Synthflow AI — MCP server on mcp.ai
> Connect your Synthflow AI account and use 79 tools for AI agents straight from your AI agent. Connect with your own API key. Synthflow AI provides AI-powered voice agents to automate both inbound and outbound calls, enhancing customer engagement and operational efficiency.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_synthflow_ai?ms=1787291280000
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/synthflow_ai/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/synthflow_ai/<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/synthflow_ai/skill.md
Postman collection (v2.1): https://mcp.ai/synthflow_ai/postman.json

## Tools
- synthflow_ai_add_kb_source_document(url?: string, name: string, type: string, content?: string, knowledge_base_id: string) — Tool to add a document to a knowledge base source. Use when you need to attach PDF files, web pages, or text content to an existing knowledge base.
- synthflow_ai_attach_actions_to_agent(actions: string[], model_id: string) — Tool to attach one or more actions to an agent. Use when you need to configure an agent with specific actions by providing the agent's model_id and an array of action IDs.
- synthflow_ai_attach_contact_to_memory_store(contact_id: string, memory_store_id: string) — Tool to attach a contact to a memory store. Use when you need to associate a specific contact with a memory store for persistent data storage.
- synthflow_ai_attach_knowledge_base_to_agent(model_id: string, knowledge_base_id: string) — Tool to attach a knowledge base to an agent. Use when you need to connect a knowledge base to a specific AI assistant by providing both IDs.
- synthflow_ai_attach_memory_store_to_agent(assistant_id: string, memory_store_id: string) — Tool to attach a memory store to an agent. Use when you need to connect a memory store resource to a specific assistant for knowledge retrieval.
- synthflow_ai_create_action(SEND_SMS?: object, CUSTOM_EVAL?: object, CUSTOM_ACTION?: object, LIVE_TRANSFER?: object, REAL_TIME_BOOKING?: object, INFORMATION_EXTRACTOR?: object) — Tool to create a new action in Synthflow AI. Use when you need to configure an action such as real-time booking, information extraction, live transfer, SMS sending, custom HTTP calls, or custom evalua
- synthflow_ai_create_assistant(name: string, type: string, agent: object, description?: string, is_recording?: boolean, max_duration?: object, phone_number?: string, caller_id_number?: string, external_webhook_url?: string, inbound_call_webhook_url?: string) — Tool to create a new assistant. Use when you need to initialize a Synthflow AI assistant by specifying its name, type, and agent configuration.
- synthflow_ai_create_contact(name: string, email?: string, phone_number: string, contact_metadata?: object) — Tool to create a new contact in Synthflow AI. Use when you need to add a contact with name and phone number.
- synthflow_ai_create_knowledge_base(name: string, rag_use_condition?: string) — Tool to create a new knowledge base and return its ID. Use when you need to set up a knowledge repository for retrieval-augmented generation (RAG) in assistants.
- synthflow_ai_create_memory_store(title: string, description?: string) — Tool to create a new memory store. Use when you need to initialize a knowledge repository for storing conversation history, customer data, or other contextual information.
- synthflow_ai_create_phone_book(name: string) — Tool to create a new phone book. Use when you need to create a contact list for organizing phone numbers in Synthflow AI.
- synthflow_ai_create_phone_book_entry(phone_number: string, phone_book_id: string, transfer_condition: string) — Tool to create a phone book entry. Use when you need to add a new phone number with a transfer condition to an existing phone book.
- synthflow_ai_create_simulation_case(name: string, type: string, prompt: string, base_agent_id?: string, success_criteria: string[], call_success_type: string) — Tool to create a new simulation case. Use when you need to set up test scenarios for evaluating assistant behavior against defined success criteria.
- synthflow_ai_create_simulation_scenario(name: string, description: string) — Tool to create a new simulation scenario. Use when you need to define a template for generating test cases to ensure coverage of specific situations.
- synthflow_ai_create_simulation_suite(name: string, language?: string, model_id: string) — Tool to create a new simulation suite attached to a specific agent. Use when you need to set up test scenarios for an agent. The suite can only execute on the agent specified by model_id.
- synthflow_ai_create_team(name: string, phone_number?: string, lead_assistant: string, external_webhook_url?: string, sub_assistants_attach?: object[]) — Tool to create a new team. Use when you need to programmatically set up a Synthflow AI assistant group with routing rules.
- synthflow_ai_delete_action(action_id: string) — Tool to delete an existing action. Use after confirming the action ID to permanently remove it.
- synthflow_ai_delete_assistant(model_id: string) — Tool to delete an existing AI assistant. Use after confirming the assistant ID. Example: Delete assistant with ID 'assistant_123'.
- synthflow_ai_delete_chat(chat_id: string) — Tool to delete a chat session. Use when you need to remove an existing chat by its ID. Confirm the chat ID before calling.
- synthflow_ai_delete_contact(contact_id: string) — Tool to delete an existing contact. Use after confirming the contact ID.
- synthflow_ai_delete_knowledge_base(knowledge_base_id: string) — Tool to delete an existing knowledge base. Use after confirming the knowledge base ID to permanently remove it.
- synthflow_ai_delete_knowledge_base_source(source_id: string, knowledge_base_id: string) — Tool to delete a source from a knowledge base. Use when you need to remove a specific source from a knowledge base after confirming both IDs.
- synthflow_ai_delete_memory_store(memory_store_id: string) — Tool to delete a memory store. Use when you need to remove a memory store after confirming its ID.
- synthflow_ai_delete_phone_book(phone_book_id: string) — Tool to delete an existing phone book. Use when you need to remove a Synthflow AI phone book after it's no longer needed. Confirm the phone book ID before calling.
- synthflow_ai_delete_phone_book_entry(entry_id: string, phone_book_id: string) — Tool to delete a phone book entry. Use when you need to remove a specific entry from a phone book. Confirm both phone_book_id and entry_id before calling.
- synthflow_ai_delete_simulation_case(simulation_case_id: string) — Tool to delete a simulation case by ID. Use after confirming the simulation case ID to remove it permanently.
- synthflow_ai_delete_simulation_scenario(scenario_id: string) — Tool to delete an existing simulation scenario. Use after confirming the scenario ID. Example: Delete simulation scenario with ID '41fc8c4a-b372-4309-813a-545505b2d0e5'.
- synthflow_ai_delete_simulation_suite(suite_id: string) — Tool to delete a simulation suite by ID. Use when you need to remove a simulation suite that is no longer needed. Confirm the suite ID before calling.
- synthflow_ai_delete_subaccount(subaccount_id: string) — Tool to delete an existing subaccount. Use after confirming the subaccount ID. Example: Delete subaccount with ID 'test_subaccount_id_12345'.
- synthflow_ai_delete_team(team_id: string) — Tool to delete an existing team. Use when you need to remove a Synthflow AI team after it's no longer needed. Confirm the team ID before calling.
- synthflow_ai_detach_action(actions?: string[], model_id: string) — Tool to detach one or more actions from an AI assistant. Use when you need to remove specific actions from an agent's configuration.
- synthflow_ai_detach_knowledge_base(model_id: string, knowledge_base_id: string) — Tool to detach a knowledge base from an AI assistant. Use when you need to remove a knowledge base association from an agent.
- synthflow_ai_detach_memory_store_contact(contact_id: string, memory_store_id: string) — Tool to detach a contact from a memory store. Use when you need to remove a contact from a specific memory store.
- synthflow_ai_detach_memory_store_from_agent(assistant_id: string, memory_store_id: string) — Tool to detach a memory store from an agent. Use when you need to remove a memory store from a specific agent/assistant.
- synthflow_ai_execute_simulation_suite(suite_id: string, max_turns?: integer, target_agent_id: string) — Tool to execute all test cases in a simulation suite. The suite runs on the target agent (must match the suite's model_id). Use when you need to validate an agent's performance against pre-configured 
- synthflow_ai_export_analytics(to_date?: string, model_id?: string, from_date?: string, type_of_call?: string) — Tool to export analytics data for calls within a specified date range. Use when you need to retrieve call analytics, filter by assistant/agent, call type, or time period. Defaults to past 7 days if no
- synthflow_ai_get_action(action_id: string) — Tool to retrieve metadata about a specific action by its ID. Use when you need to inspect an action's configuration and parameters.
- synthflow_ai_get_assistant(model_id: string) — Tool to retrieve details of a specific AI assistant. Use after confirming the assistant's ID to fetch its configuration and metadata.
- synthflow_ai_get_call(call_id: string) — Tool to retrieve the transcript and detailed metadata for a specific phone call. Use when you need to access call recordings, transcripts, duration, or telephony details for a completed call.
- synthflow_ai_get_contact(contact_id: string) — Tool to retrieve details of a specific contact by its ID. Use when you need to fetch contact information.
- synthflow_ai_get_knowledge_base(knowledge_base_id: string) — Tool to retrieve details of a specific knowledge base by its ID. Use after confirming the knowledge base ID to fetch its metadata.
- synthflow_ai_get_memory_store(memory_store_id: string) — Tool to retrieve details of a specific memory store by its ID. Use when you need to fetch metadata and configuration of an existing memory store.
- synthflow_ai_get_memory_store_contact_data(contact_id: string, memory_store_id: string) — Tool to retrieve memory data for a specific contact in a memory store. Use when you need to fetch stored memory information associated with a particular contact.
- synthflow_ai_get_numbers(limit?: integer, offset?: integer, workspace: string) — Tool to retrieve a list of phone numbers associated with a workspace. Use when you need to fetch numbers assigned to your account for a given workspace.
- synthflow_ai_get_simulation(simulation_id: string) — Tool to retrieve details of a specific simulation by ID. Use to fetch simulation results including timeline, recording, and success criteria evaluation after a simulation has been executed.
- synthflow_ai_get_simulation_case(simulation_case_id: string) — Tool to retrieve a simulation case by ID. Use when you need to fetch details of a specific simulation case including its prompt, success criteria, and metadata.
- synthflow_ai_get_simulation_scenario(scenario_id: string) — Tool to retrieve a simulation scenario by ID. Use when you need to fetch details of a specific simulation scenario template.
- synthflow_ai_get_simulation_suite(suite_id: string) — Tool to retrieve a simulation suite by ID. Use when you need to fetch details about a specific simulation suite including its test cases and associated agent information.
- synthflow_ai_get_subaccount(subaccount_id: string) — Tool to retrieve detailed metadata about a specific subaccount by ID. Use when you need to fetch subaccount information including permissions, subscription details, and members.
- synthflow_ai_get_team(team_id: string) — Tool to retrieve details of a specific team by its ID. Use after confirming the team exists to inspect its configuration.
- synthflow_ai_initialize_action(action_id: string, variables?: object[]) — Tool to initialize a custom action with specified variables. Use when you have an action ID and need to initialize it with configuration variables.
- synthflow_ai_list_actions(limit?: integer, offset?: integer) — Tool to list all actions in the workspace. Use when you need to retrieve a paginated list of available actions and their configurations.
- synthflow_ai_list_assistants(limit?: integer, offset?: string) — Tool to list all AI assistants associated with the account. Use when you need to retrieve a paginated list of assistants.
- synthflow_ai_list_calls(limit?: integer, offset?: integer, to_date?: integer, model_id: string, from_date?: integer, call_status?: string, duration_max?: integer, duration_min?: integer, lead_phone_number?: string) — Tool to retrieve call history (call logs) with filtering to check outcomes/statuses after placing calls. Use after making voice calls to list recent calls for a model, filter by phone number/time wind
- synthflow_ai_list_chats(limit?: integer, cursor?: string, agent_id?: string) — Tool to retrieve a list of chats, optionally filtered by agent ID. Use when you need to view chat history or check recent conversations.
- synthflow_ai_list_contacts(search?: string) — Tool to retrieve a list of contacts with optional search filtering. Use when you need to list all contacts or search for specific contacts by phone number.
- synthflow_ai_list_memory_stores(search?: string) — Tool to list memory stores with optional filtering by title. Use when you need to retrieve all memory stores in a workspace, optionally filtered by search term.
- synthflow_ai_list_phone_books() — Tool to list all phone books in your workspace. Use when you need to retrieve all phone books for organizing contacts in Synthflow AI.
- synthflow_ai_list_simulation_cases(search?: string, page_size?: integer, page_number?: integer, simulation_case_type?: string) — Tool to list simulation cases with pagination and optional filtering by name or type. Use when you need to retrieve simulation cases for testing agent behavior.
- synthflow_ai_list_simulation_cases_by_agent(agent_id: string) — Tool to list all simulation cases created for a specific agent. Use when you need to retrieve test scenarios associated with a particular agent ID.
- synthflow_ai_list_simulation_scenarios(search?: string, end_date?: string, page_size?: integer, start_date?: string, page_number?: integer) — Tool to list simulation scenarios with pagination and optional filtering. Use when you need to retrieve simulation scenario templates with support for search by name and date range filtering.
- synthflow_ai_list_simulation_sessions(end_date?: string, page_size?: integer, start_date?: string, page_number?: integer, target_agent_id?: string) — Tool to list simulation sessions with pagination and optional filters. Use when you need to retrieve simulation sessions, optionally filtered by target agent, date range, or paginated results.
- synthflow_ai_list_simulation_suites(search?: string, end_date?: string, model_ids?: string[], page_size?: integer, start_date?: string, page_number?: integer) — Tool to list simulation suites with pagination and optional filtering. Use when you need to retrieve simulation suites, optionally filtered by model IDs, date range, or search term.
- synthflow_ai_list_simulations(status?: string, end_date?: string, page_size?: integer, start_date?: string, page_number?: integer, target_agent_id?: string, simulation_session_id?: string) — Tool to list simulations with pagination and optional filters. Use when you need to retrieve simulation records, optionally filtered by session ID, status, date range, or target agent.
- synthflow_ai_list_subaccounts() — Tool to list all subaccounts associated with the authenticated account. Use when you need to retrieve all subaccounts and their configurations.
- synthflow_ai_list_teams() — Tool to list assistant teams. Use when you need to retrieve all teams in a workspace.
- synthflow_ai_list_voices(limit?: integer, offset?: integer, workspace: string) — Tool to list all text-to-speech voices in a workspace. Use when you need to retrieve voices available for TTS in a given workspace.
- synthflow_ai_list_webhook_logs(search?: string, status?: string, call_id?: string, to_date?: string, from_date?: string, page_size?: integer, http_method?: string, page_number?: integer, assistant_id?: string, webhook_type?: string, workspace_id: string) — Tool to retrieve paginated webhook logs with filtering and search capability. Use when you need to audit webhook delivery, check webhook statuses, troubleshoot failed webhooks, or search for specific 
- synthflow_ai_make_voice_call(name: string, phone: string, prompt?: string, greeting?: string, model_id: string, lead_email?: string, lead_timezone?: string, custom_variables?: object[]) — Tool to initiate a real-time voice call via the AI agent. Use when you have the agent ID, customer name, and phone number ready.
- synthflow_ai_start_simulation(target_agent_id: string, custom_variables?: object, simulation_case_id: string, simulation_session_id?: string) — Tool to start a new simulation using a simulation case. Use when you need to execute a test scenario against an agent to validate its behavior and performance.
- synthflow_ai_update_action(SEND_SMS?: object, action_id: string, CUSTOM_EVAL?: object, CUSTOM_ACTION?: object, LIVE_TRANSFER?: object, REAL_TIME_BOOKING?: object, INFORMATION_EXTRACTOR?: object) — Tool to update an existing action in Synthflow AI. Use when you need to modify an action's configuration such as real-time booking, information extraction, live transfer, SMS sending, custom HTTP call
- synthflow_ai_update_assistant(name?: string, agent?: object, assistant_id: string, consent_text?: string, is_recording?: boolean, max_duration?: object, phone_number?: string, caller_id_number?: string, consent_recording?: boolean, external_webhook_url?: string, is_transcript_disabled?: boolean) — Tool to update an existing assistant’s settings. Use after confirming the assistant exists. Modify settings like name, phone, recording, webhook, or agent configuration.
- synthflow_ai_update_contact(name?: string, email?: string, contact_id: string, phone_number?: string, contact_metadata?: object) — Tool to update an existing contact in Synthflow AI. Use when you need to modify contact details like name, phone, email, or metadata.
- synthflow_ai_update_knowledge_base(name?: string, knowledge_base_id: string, rag_use_condition?: string) — Tool to update an existing knowledge base's name or usage conditions. Use after confirming the knowledge base exists.
- synthflow_ai_update_memory_store(title?: string, description?: string, memory_store_id: string) — Tool to update an existing memory store's title and description. Use when you need to modify metadata of a memory store.
- synthflow_ai_update_simulation_case(name?: string, prompt?: string, success_criteria?: string[], call_success_type?: string, simulation_case_id: string) — Tool to update an existing simulation case. Use when you need to modify the name, prompt, success criteria, or evaluation method of a simulation case.
- synthflow_ai_update_simulation_scenario(name?: string, description?: string, scenario_id: string) — Tool to update an existing simulation scenario. Use when you need to modify the name or description of a scenario template.
- synthflow_ai_update_simulation_suite(name?: string, model_id?: string, suite_id: string) — Tool to update an existing simulation suite. Use when you need to modify the name or agent model of a simulation suite. At least one of name or model_id must be provided.
- synthflow_ai_update_team(name?: string, team_id: string, phone_number?: string, external_webhook_url?: string, sub_assistants_attach?: object[], sub_assistants_detach?: object[]) — Tool to update an existing team. Use after confirming the team exists and you have new configuration values.

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

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