> ## Documentation Index > Fetch the complete documentation index at: https://www.bolna.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Prompt cheatsheet > Copy-paste prompt cheatsheet for the Bolna MCP server, organized by agents, calls, batches, dispositions, and more, each linked to the tool it triggers. Paste any of these into a connected client. Each one links to the tool it triggers — see the [Tool List](/docs/mcp-tool-list) for the full schema. ## Agents ``` List my Bolna agents. ``` Triggers `list_agents`. ``` Show me the full config for agent . ``` Triggers `get_agent`. ``` Create a Hindi appointment-booking agent using Plivo and Sarvam TTS, with a welcome message that greets the caller by name. ``` Triggers `create_agent`. ``` Update agent 's welcome message to mention our new return policy. ``` Triggers `update_agent` — most clients ask you to confirm first. ``` Cancel every queued call for agent — we're pausing the campaign. ``` Triggers `stop_agent_queued_calls`. ``` Delete the test agent I created yesterday. ``` Triggers `delete_agent` — irreversible, most clients ask you to confirm first. ## Graph agents ``` Build a graph agent for Acme Dental that books appointments: greet with a static message, collect day and time, confirm, and send callers outside 10am–6pm IST to an after-hours message. Hang up after three silent turns. ``` Uses the `design_graph_agent` prompt for the design, then triggers `create_graph_agent`, which validates the graph before saving. ``` Show me the nodes and transitions in agent , and flag anything the validator complains about. ``` Triggers `get_graph_agent`. ``` In agent , add a refund_questions node reachable from welcome when the caller asks about refunds, and make the confirm prompt shorter. ``` Triggers `get_graph_agent`, then `update_graph_agent`. Most clients ask you to confirm first. ``` Validate this graph JSON and tell me which nodes are unreachable. ``` Triggers `validate_graph_agent`. Nothing is saved. ``` Send a payment_completed event with ref TXN-98765 to call . ``` Triggers `send_graph_agent_event`. The agent only reacts if the node it's on has a `payment_completed` event edge. ## Calls & executions ``` Call +91XXXXXXXXXX using my sales agent and pass customer_name: Priya as context. ``` Triggers `start_outbound_call` — spends account balance, most clients ask you to confirm first. ``` Cancel the call I scheduled for execution . ``` Triggers `stop_call`. ``` Show me agent 's last 20 calls from this week. ``` Triggers `list_agent_executions`. ``` Pull the transcript and cost for execution . ``` Triggers `get_execution`. ``` Pull the raw pipeline logs for execution and tell me whether the transcriber, LLM, or synthesizer was slow. ``` Triggers `get_execution_raw_logs`. ## Batches ``` Create a batch on my collections agent from this CSV of recipients. ``` Triggers `create_batch`. ``` Schedule batch to start calling at 9am tomorrow. ``` Triggers `schedule_batch` — starts real calls and spends balance, most clients ask you to confirm first. ``` What's the status and contact count for batch ? ``` Triggers `get_batch`. ``` List every execution in batch and tell me how many failed. ``` Triggers `list_batch_executions`. ``` Stop batch — we found an error in the recipient list. ``` Triggers `stop_batch`. ``` Delete batch , it was a test run. ``` Triggers `delete_batch` — irreversible, most clients ask you to confirm first. ## Dispositions ``` What dispositions are configured on agent ? ``` Triggers `list_dispositions`. ``` Design an extraction for whether the customer agreed to a demo. ``` Uses the Bolna MCP server's built-in `design_extraction` prompt — no skill install needed. Produces a complete category/name/prompt/answer-value design, following the same methodology as the `bolna-extraction-designer` skill (see [Skills Reference](/docs/skills-reference)), ready to hand to `create_disposition`. ``` Add a disposition to agent that captures appointment_time as a timestamp from the call. ``` Triggers `create_disposition`. ``` Add dispositions for lead_qualified (boolean), sentiment (pre-defined: positive/neutral/negative), and consent_captured (boolean) to agent . ``` Triggers `bulk_create_dispositions`. ``` Run agent 's dispositions against this sample transcript and show me what it would extract. ``` Triggers `test_dispositions`. ``` Update the sentiment disposition on agent to also flag "mixed". ``` Triggers `update_disposition`. Ask to delete one and it triggers `delete_disposition` instead — irreversible, most clients ask you to confirm first. ## Knowledgebase (RAG) ``` Create a knowledgebase from https://www.example.com/faq and let me know when it's done processing. ``` Chains `create_knowledgebase` → `get_knowledgebase` to check status. ``` List my knowledgebases and show me the status of the one named "FAQ". ``` Chains `list_knowledgebases` → `get_knowledgebase`. ``` Delete the "old-pricing" knowledgebase, it's out of date. ``` Triggers `delete_knowledgebase` — irreversible, most clients ask you to confirm first. ## Phone numbers & inbound ``` What phone numbers do I have, and which agent is each one linked to? ``` Triggers `list_phone_numbers`. ``` Find me available US numbers with area code 415. ``` Triggers `search_phone_numbers`. ``` Buy that first number you found. ``` Triggers `buy_phone_number` — spends account balance (\$5/month), most clients ask you to confirm first. ``` Set up my support agent to answer inbound calls on +1XXXXXXXXXX. ``` Triggers `setup_inbound_agent`. ``` Remove the inbound routing on +1XXXXXXXXXX, we're decommissioning that line. ``` Triggers `unlink_inbound_agent`. ``` Delete the phone number +1XXXXXXXXXX, we don't need it anymore. ``` Triggers `delete_phone_number` — irreversible, most clients ask you to confirm first. ## SIP trunks ``` Create a SIP trunk called "primary" for my Telnyx account. Send outbound calls to sip.example-carrier.com with my carrier username and password, and accept inbound calls from 203.0.113.10. ``` Triggers `create_trunk`, with the gateway and carrier IP in the same call. ``` What do I need to configure at my carrier to connect it to Bolna? ``` Triggers `get_trunk_connection_details`. ``` List my SIP trunks and show me the config for the one named "primary". ``` Chains `list_trunks` → `get_trunk`. ``` Add +1XXXXXXXXXX to my "primary" trunk and have my support agent answer it. ``` Triggers `add_number_to_trunk` with the agent set. Ask to move the number to another agent and it triggers `assign_trunk_number_agent`; ask to remove it and it triggers `remove_number_from_trunk`. ``` Place a test call through my "primary" trunk to +1XXXXXXXXXX. ``` Chains `start_trunk_test_call` → `get_trunk_test_call`. Ask to test inbound instead and it chains `arm_trunk_inbound_test` → `get_trunk_inbound_test`, answering your next call to the trunk with an echo. ``` Show me the recent failed calls on my "primary" trunk with their SIP codes. ``` Triggers `list_trunk_calls`. ``` Delete the SIP trunk named "old-vendor". ``` Triggers `delete_trunk` — irreversible, most clients ask you to confirm first. Legacy SIP trunks (deprecated) are managed with their own tools; see the [Tool list](/docs/mcp-tool-list#legacy-sip-trunks-deprecated). ## Sub-accounts ``` Create a sub-account called "Acme Corp". ``` Triggers `create_sub_account`. ``` List my sub-accounts. ``` Triggers `list_sub_accounts`. ``` Get the API key for my "Acme Corp" sub-account, then use it to list that sub-account's agents. ``` Chains `list_sub_accounts` → `list_agents` with the returned key passed as `api_key` — no reconnecting needed. See [Calling tools with a different account](/docs/mcp-tool-list#calling-tools-with-a-different-account). ``` What did the "Acme Corp" sub-account spend this month? ``` Triggers `get_sub_account_usage`. ``` Show me usage for all of my sub-accounts. ``` Triggers `get_all_sub_accounts_usage`. ``` Delete the "Acme Corp" sub-account, the engagement ended. ``` Triggers `delete_sub_account` — irreversible, most clients ask you to confirm first. ## Voice & providers ``` What telephony, LLM, and voice providers are connected to my account? ``` Triggers `list_providers`. ``` What TTS providers and voices do I have available? I want a calm female Hindi voice. ``` Chains `list_tts_providers` → `list_voices`. ``` Remove my old ElevenLabs connection. ``` Triggers `remove_provider` — breaks any agent still using it, most clients ask you to confirm first. ## Violations ``` List any pending violations on my account. ``` Triggers `list_violations`. Ask for a different status ("accepted", "rejected", "submitted") and it filters accordingly. ## Account ``` What's my current wallet balance and concurrency limit? ``` Triggers `get_user_info`. ## Documentation ``` How do I set up a webhook in Bolna? ``` Triggers `search_docs`. ``` Show me the full content of the MCP tool list doc. ``` Chains `search_docs` → `get_doc`. ## Chained, multi-step These touch more than one tool in a single request — the assistant chains the lookups itself. ``` Check agent 's last 10 calls — for any that didn't complete, tell me why. ``` Chains `list_agent_executions` → `get_execution`. ``` If my wallet balance is above ₹500, call +91XXXXXXXXXX with my onboarding agent. ``` Chains `get_user_info` → `start_outbound_call`. ``` Which of my agents don't have a webhook set up? ``` Chains `list_agents` → `get_agent` per agent. ``` Delete any agents I made today with "test" in the name. ``` Chains `list_agents` → `delete_agent`; expect a confirmation prompt per delete. ``` Find me an available number in area code 415, buy it, and route it to my support agent. ``` Chains `search_phone_numbers` → `buy_phone_number` → `setup_inbound_agent`; expect a confirmation prompt before the purchase. How the server works and what you can do with it Use these prompts to explore your data, then have your assistant build a small dashboard around it This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.