Model Context Protocol (MCP) | Pinnacle

The Model Context Protocol (MCP) is an open standard for connecting Large Language Models (LLMs) to platforms like Pinnacle. Once connected, your AI assistant can send SMS, MMS, and RCS messages, manage contacts and conversations, check phone number capabilities, and search our documentation — all on your behalf.

MCP Installation

Step 1: Configure your AI tool

Get your API key from the Pinnacle Dashboard, enter it below, and copy the configuration for your client.

Step 2: Verify the connection

Restart your AI client — some clients require a restart to detect new MCP servers.
Test the connection by asking:

“What phone numbers do I have available? Use MCP tools.”
Your AI assistant should call the Pinnacle MCP tools and return results from your account.

Troubleshooting

If tools aren’t detected after restarting, double-check your API key and ensure the server URL is correct.

Available Tools

The Pinnacle MCP server exposes 28 tools organized by feature group.

Messaging

Tool	Description
`send_sms`	Send an SMS message to a phone number
`send_mms`	Send an MMS message with text and/or media files
`send_rcs`	Send a rich RCS message with cards, buttons, and quick replies
`get_message`	Retrieve details of a previously sent message by ID
`send_typing_indicator`	Show a typing indicator from an RCS agent

Conversations

Tool	Description
`list_conversations`	List conversations with optional filtering
`get_conversation`	Get a specific conversation by ID or phone numbers
`list_conversation_messages`	Get messages within a conversation
`update_conversation`	Update notes on a conversation

Contacts

Tool	Description
`get_contact`	Look up a contact by ID or phone number
`create_contact`	Create a new contact
`update_contact`	Update an existing contact

Audiences

Tool	Description
`get_audience`	Get an audience by ID with optional pagination
`create_audience`	Create a new audience with optional initial contacts

Bulk Messaging

Tool	Description
`blast_sms`	Send an SMS to all contacts in an audience
`blast_mms`	Send an MMS to all contacts in an audience
`blast_rcs`	Send an RCS message to all contacts in an audience

Phone Numbers

Tool	Description
`search_phone_numbers`	Search available phone numbers to purchase
`get_phone_number_details`	Get carrier, location, and contact info for any number

RCS

Tool	Description
`get_rcs_capabilities`	Check if phone numbers support RCS and which features

Status

Tool	Description
`get_brand_status`	Check brand registration status
`get_dlc_campaign_status`	Check 10DLC campaign status
`get_toll_free_campaign_status`	Check toll-free campaign status
`get_rcs_campaign_status`	Check RCS campaign status
`get_phone_number_status`	Check if a phone number is active

Utility Tools

Tool	Description
`create_shortened_url`	Create a tracked short URL (pncl.to)
`upload_file`	Generate upload/download URLs for file storage

Documentation

Tool	Description
`search_pinnacle_docs`	Search Pinnacle docs for guides, API references, and examples

Configuration Options

Option	Description	Example
Remote URL	Hosted Streamable HTTP server	`https://mcp.pinnacle.sh/mcp`
npm package	Local stdio via npx	`npx @pinnacle-rcs/mcp`
API key (remote)	Passed as HTTP header	`PINNACLE-API-KEY: pnclk_...`
API key (local)	Passed as environment variable	`PINNACLE_API_KEY=pnclk_...`

Example Prompts

Here are some things you can ask your AI assistant once connected:

“Send an SMS to +14155551234 from my number saying ‘Meeting at 3pm’”
“Check if +14155551234 supports RCS”
“Show me my recent conversations”
“Create a new audience called ‘Beta Testers’ with these numbers: +14155551234, +14155556789”
“Blast an SMS to my VIP audience saying ‘Flash sale today!’”
“Search the Pinnacle docs for how to set up RCS”
“What’s the status of my brand registration?”

Source Code

The MCP server is open source: github.com/pinnacle-dev/pinnacle-mcp