MCP Tools Reference

SmartAlex has 80 tools, all prefixed smartalex_ so they never clash with other MCP servers. Your AI app reads each tool’s inputs from the server itself, so you never type them. Just ask in plain words, for example “pause the spring campaign”. Your AI app only gets the tools your role, plan and add-ons allow. In the Notes column:

Asks first: the server returns a preview, and the action runs only after you approve it. See Security and permissions.
Outbound Campaigns or Power Tools: needs that add-on.
Owner or admin: only workspace owners and admins get it.

Contacts

Tool	What it does	Notes
`smartalex_list_contacts`	List the contacts in your workspace
`smartalex_get_contact`	Get one contact by its ID
`smartalex_create_contact`	Create a new contact
`smartalex_update_contact`	Add to or change a contact’s details
`smartalex_import_contacts`	Add up to 1,000 people at once, like the spreadsheet import
`smartalex_delete_contact`	Delete one contact for good	Asks first

Agents and prompts

Tool	What it does	Notes
`smartalex_list_agents`	List your voice agents
`smartalex_get_agent`	Get one agent’s full settings
`smartalex_create_agent`	Create a voice agent, from a website or from a name and description	Needs a free agent slot
`smartalex_update_agent`	Change an agent’s settings
`smartalex_delete_agent`	Delete an agent for good	Asks first
`smartalex_get_agent_prompt`	Read an agent’s prompt, section by section
`smartalex_update_agent_prompt_section`	Replace the text of one prompt section, saved as a new version
`smartalex_get_prompt_history`	List past changes to an agent’s prompt
`smartalex_revert_prompt_section`	Put an earlier version of a prompt section back

Knowledge

Tool	What it does	Notes
`smartalex_list_knowledge`	List the documents and web pages in your knowledge base
`smartalex_add_knowledge_text`	Save pasted text as a knowledge document
`smartalex_add_knowledge_from_website`	Import web pages into the knowledge base	Asks first (pages past your allowance are charged)
`smartalex_get_knowledge_import_status`	Check a website import and save the pages that are ready
`smartalex_delete_knowledge_item`	Delete a document or web page for good	Asks first
`smartalex_link_knowledge_to_agent`	Let an agent use knowledge documents on its calls
`smartalex_unlink_knowledge_from_agent`	Stop an agent using knowledge documents

Phone numbers

Tool	What it does	Notes
`smartalex_list_phone_numbers`	List your phone numbers
`smartalex_search_available_numbers`	Search numbers you can buy, by country
`smartalex_buy_phone_number`	Buy a phone number	Asks first, Outbound Campaigns
`smartalex_assign_phone_number`	Choose which agent answers a number, and whether it calls out from it
`smartalex_release_phone_number`	Give up a phone number for good	Asks first

Campaigns

All campaign tools need the Outbound Campaigns add-on.

Tool	What it does	Notes
`smartalex_list_campaigns`	List your campaigns
`smartalex_get_campaign`	Get one campaign
`smartalex_create_campaign`	Create a campaign
`smartalex_update_campaign`	Change a campaign’s settings
`smartalex_add_contacts_to_campaign`	Add people to a campaign	Asks first
`smartalex_remove_contacts_from_campaign`	Take people off a campaign before they are called
`smartalex_start_campaign`	Start calling	Asks first
`smartalex_pause_campaign`	Pause a running campaign
`smartalex_resume_campaign`	Carry on calling with a paused campaign	Asks first
`smartalex_schedule_campaign`	Set when a campaign starts calling by itself	Asks first
`smartalex_stop_campaign`	End a campaign for good	Asks first

Calls and analytics

Tool	What it does	Notes
`smartalex_list_calls`	List your calls
`smartalex_get_call`	Get one call, with its transcript and summary
`smartalex_get_campaign_call_summary`	Count and summarise the calls for a campaign or a date range
`smartalex_export_calls`	Make a download link for one month of call records
`smartalex_get_analytics`	Show what the Analytics page shows for a period

Deals

Tool	What it does	Notes
`smartalex_list_deals`	List the deals in your pipeline
`smartalex_create_deal`	Create a deal
`smartalex_update_deal`	Change a deal
`smartalex_delete_deal`	Delete a deal for good	Asks first

Callbacks and blocked callers

Tool	What it does	Notes
`smartalex_list_callbacks`	List the people waiting for a call back
`smartalex_update_callback`	Move a callback to another day and time
`smartalex_cancel_callback`	Cancel a callback that is still waiting
`smartalex_call_back_now`	Have the agent phone someone back right away	Asks first
`smartalex_list_blocked_callers`	List the numbers blocked from calling you
`smartalex_block_caller`	Block a number from calling you
`smartalex_unblock_caller`	Unblock a number

Webhooks

Tool	What it does	Notes
`smartalex_list_webhooks`	List your webhooks	Owner or admin
`smartalex_create_webhook`	Create a webhook. Its signing secret is shown once	Owner or admin, Power Tools
`smartalex_delete_webhook`	Delete a webhook	Asks first, Owner or admin, Power Tools

HTTP tools

HTTP tools let an agent call your own systems during a phone call, for example to look up an order. All of these need the Power Tools add-on.

Tool	What it does	Notes
`smartalex_list_http_tools`	List your HTTP tools
`smartalex_create_http_tool`	Create an HTTP tool
`smartalex_update_http_tool`	Change an HTTP tool, or switch it on or off
`smartalex_delete_http_tool`	Delete an HTTP tool	Asks first
`smartalex_attach_http_tool_to_agent`	Give an agent an HTTP tool
`smartalex_detach_http_tool_from_agent`	Take an HTTP tool away from an agent
`smartalex_preview_http_tool_request`	Show the exact request an agent would send, with keys masked

Team

Tool	What it does	Notes
`smartalex_list_team`	List the people in your workspace and open invitations
`smartalex_invite_team_member`	Email someone an invitation, with a role	Asks first
`smartalex_change_member_role`	Change a team member’s role
`smartalex_remove_team_member`	Remove someone from your workspace	Asks first
`smartalex_revoke_invitation`	Cancel an invitation that has not been accepted

Which team tools work for you depends on your role, as it does in SmartAlex.

Workspace settings

Tool	What it does	Notes
`smartalex_get_business_hours`	Show your business hours and whether you are open now
`smartalex_update_business_hours`	Change your business hours
`smartalex_get_notification_settings`	Show which events reach you, and where
`smartalex_update_notification_settings`	Switch your own notifications on or off

Account, testing and help

Tool	What it does	Notes
`smartalex_get_plan_and_usage`	Show your plan, add-ons, minutes left, wallet balance and agent slots
`smartalex_buy_agent_slot`	Add one more agent slot	Asks first
`smartalex_start_test_call`	Have one of your agents phone a number now, as a test	Asks first
`smartalex_get_test_call_result`	Read how a test call went, with the transcript
`smartalex_get_widget_install_code`	Get the website widget install code
`smartalex_get_platform_status`	Check that SmartAlex is up, with counts of contacts, campaigns, calls and deals
`smartalex_search_company_knowledge`	Search SmartAlex product information and setup guides

Security and permissions

What asks first, and how to disconnect an AI app.

Usage examples

Real workflows, as conversations.

Start here

Install & connect

Reference

Guides

MCP Tools Reference

MCP Tools Reference

Contacts

Agents and prompts

Knowledge

Phone numbers

Campaigns

Calls and analytics

Deals

Callbacks and blocked callers

Webhooks

HTTP tools

Team

Workspace settings

Account, testing and help

Security and permissions

Usage examples

​MCP Tools Reference

​Contacts

​Agents and prompts

​Knowledge

​Phone numbers

​Campaigns

​Calls and analytics

​Deals

​Callbacks and blocked callers

​Webhooks

​HTTP tools

​Team

​Workspace settings

​Account, testing and help

Security and permissions

Usage examples

MCP Tools Reference

Contacts

Agents and prompts

Knowledge

Phone numbers

Campaigns

Calls and analytics

Deals

Callbacks and blocked callers

Webhooks

HTTP tools

Team

Workspace settings

Account, testing and help