# How to integrate Vapi MCP with Atomic Agent ```json { "title": "How to integrate Vapi MCP with Atomic Agent", "toolkit": "Vapi", "toolkit_slug": "vapi", "framework": "Atomic Agent", "framework_slug": "atomic-agent", "url": "https://composio.dev/toolkits/vapi/framework/atomic-agent", "markdown_url": "https://composio.dev/toolkits/vapi/framework/atomic-agent.md", "updated_at": "2026-08-11T13:05:30.833Z" } ``` ## Introduction Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Vapi. This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Vapi account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions. ## Also integrate Vapi with - [OpenAI Agents SDK](https://composio.dev/toolkits/vapi/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/vapi/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/vapi/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/vapi/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/vapi/framework/codex) - [OpenClaw](https://composio.dev/toolkits/vapi/framework/openclaw) - [Hermes](https://composio.dev/toolkits/vapi/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/vapi/framework/google-adk) - [LangChain](https://composio.dev/toolkits/vapi/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/vapi/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/vapi/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/vapi/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/vapi/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/vapi/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/vapi/framework/autogen) ## TL;DR ### How Atomic Agent connects to Vapi Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication. Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account. ## Connect Vapi to Atomic Agent ### Connect Vapi to Atomic Agent - Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key. - In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart. - Ask Atomic Agent to do something in Vapi. It searches Composio for the right tool. - On first use, open the sign-in link returned in the chat. Connect your Vapi account, then return to Atomic Agent to continue. ### Headless setup Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file. ```bash COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY ``` ## What is the Vapi MCP server, and what's possible with it? The Vapi MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Vapi account. It provides structured and secure access so your agent can perform Vapi operations on your behalf. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `VAPI_ASSISTANT_CONTROLLER_UPDATE` | Update Assistant | Tool to update an existing Vapi assistant configuration. Use when you need to modify assistant properties such as name, voice settings, transcriber configuration, model settings, messages, or other behavior parameters. Only include fields you want to update. | | `VAPI_CALL_CONTROLLER_FIND_ALL` | List Calls | Tool to list calls from Vapi. Use when you need to retrieve multiple calls with optional filtering by id, assistantId, phoneNumberId, or date ranges. Returns an array of call objects with details including status, costs, messages, and artifacts. | | `VAPI_CHAT_CONTROLLER_DELETE_CHAT` | Delete Chat | Tool to delete a chat by its ID from Vapi. Use when you need to permanently remove a chat conversation. | | `VAPI_CHAT_CONTROLLER_GET_CHAT` | Get Chat | Tool to fetch chat details by ID. Use when you have a chat ID and need full chat information including messages, costs, and configuration. | | `VAPI_CREATE_ANALYTICS_QUERIES` | Create Analytics Queries | Tool to create and execute analytics queries on VAPI data. Use when you need to analyze call or subscription metrics with aggregations like count, sum, average, min, or max. Supports grouping by various dimensions and time-based analysis with custom time ranges. | | `VAPI_CREATE_ASSISTANT` | Create Assistant | Tool to create a new Vapi assistant with specified transcriber, voice, and AI model configurations. Use when setting up a conversational AI assistant for voice interactions. The assistant requires transcription (speech-to-text), voice (text-to-speech), and AI model (conversation logic) configurations at minimum. | | `VAPI_CREATE_EVAL` | Create Eval | Tool to create an eval for testing conversation flows. Use when you need to validate that an AI assistant responds correctly to specific conversation scenarios. | | `VAPI_CREATE_OPENAI_CHAT` | Create OpenAI Chat | Tool to create an OpenAI-compatible chat using the Vapi API. Use when you need to send a chat message to an assistant or squad and receive a response. Supports both streaming and non-streaming modes. | | `VAPI_CREATE_PHONE_NUMBER` | Create Phone Number | Tool to create a phone number with Vapi. Supports multiple providers including byo-phone-number, twilio, vonage, vapi, and telnyx. Use this to provision new phone numbers for handling voice calls. For vapi provider, only provider field is required; other fields are optional based on provider type. | | `VAPI_CREATE_MONITORING_POLICY` | Create Monitoring Policy | Tool to create a monitoring policy in VAPI. Use when you need to set up automated monitoring rules based on thresholds and time windows. Policies can trigger alerts based on event counts or percentages over a specified lookback window. | | `VAPI_CREATE_PROVIDER_RESOURCE` | Create Provider Resource | Tool to create an 11Labs pronunciation dictionary resource. Use when you need to define custom pronunciations for specific terms or acronyms in voice synthesis. | | `VAPI_CREATE_SCORECARD` | Create Scorecard | Tool to create a scorecard for observability and evaluation. Use when setting up metrics to evaluate assistant performance based on structured outputs. Scorecards contain metrics with conditions that calculate normalized scores on a 100-point scale. | | `VAPI_DELETE_CALL` | Delete Call | Tool to delete a call by its unique identifier. Use when you need to remove call data from the system. Returns the deleted call object with all its associated data. | | `VAPI_DELETE_EVAL` | Delete Eval | Tool to delete an eval by ID. Use when you need to permanently remove an eval from the system. | | `VAPI_DELETE_PHONE_NUMBER` | Delete Phone Number | Tool to delete a phone number from Vapi. Use when you need to remove a phone number from your Vapi organization. Returns the deleted phone number object. | | `VAPI_GET_EVAL` | Get Eval | Tool to retrieve an eval by its ID. Use when you need to fetch details about a specific eval including its mock conversation messages and metadata. | | `VAPI_DELETE_EVAL_RUN` | Delete Eval Run | Tool to delete an eval run by its ID from Vapi. Use when you need to permanently remove an evaluation run. | | `VAPI_UPDATE_EVAL` | Update Eval | Tool to update an existing eval in Vapi. Use when you need to modify eval properties like name, description, type, or mock conversation messages. | | `VAPI_GET_ASSISTANT` | Get Assistant | Tool to retrieve a specific assistant by ID from Vapi. Use when you need to fetch details about an existing assistant. | | `VAPI_GET_CALL` | Get Call | Tool to fetch call details by ID. Use when you have a call ID and need full call information including status, duration, costs, messages, and recordings. | | `VAPI_GET_FILE` | Get File | Tool to retrieve a file by its ID from Vapi. Use when you need to get details about a specific file including its status, metadata, storage location, and timestamps. | | `VAPI_GET_INSIGHTS` | Get Insights | Tool to retrieve insights from Vapi. Use when you need to fetch insight data with optional filtering by ID, timestamps, or pagination. Returns a paginated list of insights with metadata. | | `VAPI_LIST_MONITORING_POLICIES` | List Monitoring Policies | Tool to retrieve monitoring policies from Vapi. Use when you need to list, filter, or search for monitoring policies configured in the organization. Supports filtering by policy ID, severity level, monitor ID, and date ranges for creation/update timestamps. | | `VAPI_GET_OBSERVABILITY_SCORECARD` | Get Observability Scorecard | Tool to list observability scorecards with optional filtering and pagination. Use when you need to retrieve scorecards for monitoring or analysis. | | `VAPI_LIST_PROVIDER_RESOURCES` | List Provider Resources | Tool to list provider resources from Vapi. Use when you need to retrieve pronunciation dictionaries or other resources from providers like 11labs or Cartesia. | | `VAPI_LIST_STRUCTURED_OUTPUTS` | List Structured Outputs | Tool to list structured outputs with optional filtering. Use when you need to retrieve structured output configurations with pagination support. Supports filtering by ID, name, timestamps, and includes pagination controls. | | `VAPI_GET_INSIGHTS` | Get Insights | Tool to retrieve insights from VAPI. Use when you need to list insights with optional filtering by ID, creation date, or update date. Supports pagination and sorting. | | `VAPI_LIST_ASSISTANTS` | List Assistants | Tool to list all assistants in your VAPI organization. Use when you need to retrieve information about configured assistants. Supports filtering by creation and update timestamps. | | `VAPI_LIST_CHATS` | List Chats | Tool to retrieve a list of chat conversations from VAPI. Use when you need to view existing chats, optionally filtered by assistant, squad, session, or time range. Supports pagination and sorting for efficient retrieval of large chat histories. | | `VAPI_LIST_EVALS` | List Evals | Tool to retrieve a paginated list of evals from Vapi. Use when you need to list or search evals with optional filtering by creation/update timestamps. | | `VAPI_LIST_PROVIDER_RESOURCES` | List Provider Resources | Tool to retrieve provider resources from Vapi (e.g., 11labs pronunciation dictionaries). Use when you need to list or search provider-specific resources with optional filtering by timestamps. | | `VAPI_UPDATE_INSIGHT` | Update Insight | Tool to update an existing insight configuration in VAPI. Use when you need to modify insight properties like name, queries, time range, or visualization settings. Supports all four insight types (bar, pie, line, text) with type-specific configurations. | | `VAPI_CREATE_PHONE_NUMBER` | Create Phone Number | Tool to create a phone number with VAPI. Use when you need to provision a new phone number for voice AI applications. Supports multiple providers (VAPI, Twilio, Vonage, Telnyx, BYO). Required parameters vary by provider. | | `VAPI_LIST_SCORECARDS` | List Scorecards | Tool to retrieve a paginated list of scorecards from Vapi. Use when you need to list or search scorecards with optional filtering by creation/update timestamps. | | `VAPI_CREATE_SESSION` | Create Session | Tool to create a new session in Vapi. Use when you need to establish a persistent conversation context that can span multiple chats. Sessions automatically expire after 24 hours. | | `VAPI_LIST_SESSIONS` | List Sessions | Tool to retrieve a paginated list of sessions from VAPI. Use when you need to list sessions with optional filtering by session ID, name, assistant, squad, or workflow. Supports pagination, sorting, and timestamp-based filtering. | | `VAPI_LIST_STRUCTURED_OUTPUTS` | List Structured Outputs | Tool to list structured outputs with optional filtering and pagination. Use when you need to retrieve structured output configurations from Vapi. | | `VAPI_GET_TOOL` | Get Tool | Tool to fetch tool details by ID. Use when you have a tool ID and need full tool configuration including type, messages, function definitions, and server settings. | | `VAPI_TEST_CODE_TOOL_EXECUTION` | Test Code Tool Execution | Tool to test TypeScript code execution in Vapi's code tool environment. Use when validating code before deploying it as a tool. | | `VAPI_UPDATE_TOOL` | Update Tool | Tool to update an existing Vapi tool configuration. Use when you need to modify tool properties such as function definitions, server settings, messages, or other tool-specific parameters. | | `VAPI_UPDATE_PHONE_NUMBER` | Update Phone Number | Tool to update an existing phone number configuration in VAPI. Use when you need to modify phone number settings such as name, associated assistant/workflow, or provider-specific configurations. | | `VAPI_UPLOAD_FILE` | Upload File | Tool to upload a file to Vapi Knowledge Base. Use when you need to add files for AI assistants to reference. Returns file metadata including ID, storage URLs, and processing status. | ## Supported Triggers None listed. ## Troubleshooting ### Why is my API key rejected? Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying. ### Why are Composio tools unavailable after saving a key? Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk. ### Does Composio have a free plan? The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection. ## Complete Code None listed. ## Conclusion ### Use Vapi from Atomic Agent With your account connected, ask Atomic Agent to work with Vapi in natural language. You can connect more apps through the same Composio integration as you need them. Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo). ## How to build Vapi MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/vapi/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/vapi/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/vapi/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/vapi/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/vapi/framework/codex) - [OpenClaw](https://composio.dev/toolkits/vapi/framework/openclaw) - [Hermes](https://composio.dev/toolkits/vapi/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/vapi/framework/google-adk) - [LangChain](https://composio.dev/toolkits/vapi/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/vapi/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/vapi/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/vapi/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/vapi/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/vapi/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/vapi/framework/autogen) ## Related Toolkits - [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed. - [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service. - [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows. - [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow. - [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows. - [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application. - [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities. - [AltTextLab](https://composio.dev/toolkits/alt_text_lab) - AltTextLab is an AI service that generates accessible, SEO-aware alt text for images. It helps teams make image content easier to understand, index, and publish. - [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization. - [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications. - [Apiframe](https://composio.dev/toolkits/apiframe) - Apiframe is an API platform for generating and managing AI images, videos, music, uploads, assets, jobs, and custom LoRAs. It gives developers one clean API for creative AI workflows without juggling multiple model providers. - [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations. - [Arize AX](https://composio.dev/toolkits/arize_ax) - Arize AX is an AI engineering platform for tracing, evaluating, and improving AI applications. Use it to debug LLM behavior, compare experiments, and improve production AI quality. - [Artificial Analysis](https://composio.dev/toolkits/artificial_analysis) - Artificial Analysis is an independent benchmarking platform for AI models and API providers. Use it to compare model intelligence, coding, math, pricing, latency, throughput, and arena rankings. - [AssemblyAI](https://composio.dev/toolkits/assemblyai) - AssemblyAI is a speech-to-text and audio intelligence API for uploaded or hosted media. Use it to turn audio and video into accurate transcripts, summaries, and insights. - [Astica ai](https://composio.dev/toolkits/astica_ai) - Astica ai provides APIs for computer vision, NLP, and voice synthesis. Integrate advanced AI features into your app with a single API key. - [Avoma](https://composio.dev/toolkits/avoma) - Avoma is an AI meeting assistant for recording, transcribing, analyzing, and managing meetings, calls, notes, scorecards, and conversation intelligence. It helps teams turn conversations into searchable notes, follow-ups, coaching insights, and revenue intelligence. - [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient. - [Bland AI](https://composio.dev/toolkits/bland_ai) - Bland AI is a conversational AI platform for building voice agents, phone calls, messaging, and communication workflows. Use it to automate calling, evaluate conversations, and run voice operations at scale. - [Botbaba](https://composio.dev/toolkits/botbaba) - Botbaba is a platform for building, managing, and deploying conversational AI chatbots across messaging channels. It streamlines chatbot automation, making it easier to integrate AI into customer interactions. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Vapi MCP? With a standalone Vapi MCP server, the agents and LLMs can only access a fixed set of Vapi tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Vapi and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Atomic Agent? Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Vapi tools. ### Can I manage the permissions and scopes for Vapi while using Tool Router? Yes, absolutely. You can configure which Vapi scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Vapi data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)