Integrations & MCP

Integrations let your AI agent access external services like CRMs, calendars, and custom APIs. Your agent can look up customer data, schedule appointments, send messages, and more - all during live conversations.

Overview

Magpipe supports three types of integrations:

Type	Description	Examples
OAuth Integrations	Connect with a click using OAuth	HubSpot, Slack, Cal.com
MCP Catalog	Pre-configured MCP servers ready to connect	Brave Search, GitHub, Notion, Stripe
Custom MCP Servers	Add your own MCP-compatible servers	Internal APIs, custom tools

OAuth Integrations

Available Integrations

HubSpot

Create contacts, search CRM, add notes

Slack

Send messages, list channels

Cal.com

Check availability, book appointments

Connecting an Integration

Go to Settings → Apps
Find the integration you want
Click Connect
Authorize access in the popup
Integration is now available to your agents

HubSpot Tools

Once connected, your agent can:

Tool	Description
`hubspot_create_contact`	Create a new contact in HubSpot
`hubspot_search_contacts`	Search contacts by name, email, or phone
`hubspot_get_contact`	Get full contact details by email
`hubspot_create_note`	Add a note to a contact record

Example conversation:

Caller: “Can you add me to your system? I’m John Smith, john@example.com” Agent: Creates contact in HubSpot “I’ve added you to our system, John. Is there anything else I can help with?”

Slack Tools

Tool	Description
`slack_send_message`	Send a message to a channel
`slack_list_channels`	List available channels (public and private)

Private channels are fully supported. The Magpipe bot must be invited to any private channel you want to use. If you connected Slack before March 2026, disconnect and reconnect to grant the updated permissions.

Calendar Tools

Tool	Description
`check_calendar_availability`	Find available time slots
`book_calendar_appointment`	Schedule an appointment

MCP Server Catalog

The MCP (Model Context Protocol) catalog includes 40+ pre-configured servers for popular services.

Featured Servers

Server	Category	Tools
Brave Search	Search	Web search, summarization
GitHub	Development	Repos, issues, PRs
Notion	Productivity	Pages, databases
Stripe	Payments	Customers, charges
Shopify	E-commerce	Orders, products
Salesforce	CRM	Leads, opportunities
Linear	Project Management	Issues, projects
Google Calendar	Calendar	Events, availability

Connecting a Catalog Server

Go to Settings → Apps → MCP Servers
Browse the catalog
Click Connect on the server you want
Enter your API key (if required)
Tools are now available to your agents

Most MCP servers require an API key from the service provider. Check the server’s documentation for how to obtain one.

Full Catalog

Search & AI

Brave Search, Exa, Perplexity

Development

GitHub, GitLab, Linear, Sentry

Productivity

Notion, Asana, Trello, Airtable, Jira

Communication

Slack, Discord, Twilio

CRM & Sales

HubSpot, Salesforce, Zendesk

E-commerce & Payments

Stripe, Shopify

Databases

PostgreSQL, MongoDB, Supabase, SQLite

Cloud & Infrastructure

Cloudflare, Vercel, AWS

Storage

Google Drive, Dropbox

Marketing

Mailchimp, Mailgun

Design

Figma

Automation

Zapier, Make

Custom MCP Servers

Add your own MCP-compatible servers to give agents access to internal tools and APIs.

Adding a Custom Server

Go to Settings → Apps → MCP Servers
Click Add Custom Server
Enter:
- Name: Display name for the server
- URL: HTTPS endpoint (e.g., https://mcp.yourcompany.com/v1)
- Auth Type: None, API Key, or Bearer Token
- API Key: If required
Click Validate to test the connection
If successful, click Add Server

Requirements

Custom MCP servers must:

Use HTTPS (HTTP not allowed)
Implement the MCP JSON-RPC protocol
Respond to tools/list and tools/call methods
Be publicly accessible (no localhost or internal IPs)

Authentication Options

Type	Header	Description
None	-	No authentication
API Key	`X-API-Key`	API key in header
Bearer	`Authorization: Bearer`	Token authentication

Example MCP Server Response

// tools/list response
{
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "lookup_order",
        "description": "Look up an order by ID",
        "inputSchema": {
          "type": "object",
          "properties": {
            "order_id": { "type": "string" }
          },
          "required": ["order_id"]
        }
      }
    ]
  }
}

How Agents Use Tools

When your agent is on a call or chat, it can invoke any connected tool:

Caller: "What's the status of my order 12345?"
         ↓
Agent decides to call: lookup_order({ order_id: "12345" })
         ↓
MCP server returns order details
         ↓
Agent: "Your order 12345 shipped yesterday and should arrive Friday."

Tool Naming

Tools are prefixed by their source:

Source	Format	Example
Built-in	`tool_name`	`send_sms`
OAuth Integration	`provider_tool`	`hubspot_create_contact`
MCP Server	`server:tool`	`brave_search:search`

Preview Mode

Destructive actions use a preview-then-execute pattern:

Preview: Agent shows what will happen
Confirm: User approves the action
Execute: Action is performed

This prevents accidental changes and gives users control.

Built-in Tools

Every agent has access to these core tools:

Tool	Description
`send_sms`	Send an SMS message
`call_contact`	Initiate a phone call
`list_contacts`	List contacts
`add_contact`	Add a new contact
`schedule_sms`	Schedule SMS for later
`search_business`	Look up business info
`add_knowledge_source`	Add URL to knowledge base

Managing Integrations

Check Status

View all connected integrations in Settings → Apps. Each shows:

Connection status (connected, expired, error)
Last used timestamp
Available tools

Disconnect

To remove an integration:

Go to Settings → Apps
Find the integration
Click Disconnect
Confirm removal

Disconnecting an integration immediately removes agent access to those tools. Active calls using the integration may encounter errors.

Refresh Tokens

OAuth integrations automatically refresh tokens before expiry. If a token expires:

The integration shows “Expired” status
Click Reconnect to re-authorize
Tools are available again

Tool Execution Logs

All tool executions are logged for debugging and audit:

Tool name and source
Input parameters
Output/response
Success/failure status
Execution time

Access logs in Settings → Apps → Activity Log.

API Access

List Available Tools

curl "https://api.magpipe.ai/functions/v1/mcp-tools" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "tools": [
    { "name": "send_sms", "description": "Send SMS message", ... },
    { "name": "hubspot_create_contact", "description": "Create HubSpot contact", ... }
  ],
  "integrations": {
    "connected": ["hubspot", "slack"],
    "available": ["cal_com", "notion"]
  },
  "mcp_servers": [
    { "id": "...", "name": "Brave Search", "type": "catalog", "tools": [...] }
  ]
}

Execute a Tool

curl -X POST "https://api.magpipe.ai/functions/v1/mcp-execute" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "hubspot_search_contacts",
    "arguments": {
      "query": "john@example.com"
    },
    "mode": "execute"
  }'

Security

HTTPS Only: All MCP servers must use HTTPS
Token Encryption: API keys are stored encrypted
Row-Level Security: Users can only access their own integrations
Audit Logging: All tool executions are logged
URL Validation: Internal/localhost URLs are blocked

FAQ

Can I use integrations on voice calls?

Yes! Agents can use any connected tool during live voice calls. The agent decides when to invoke tools based on the conversation.

How do I know which tools my agent can use?

Go to Settings → Apps to see all connected integrations and their available tools. The agent automatically has access to all tools from connected integrations.

Can I limit which tools an agent uses?

Currently, agents have access to all connected tools. Per-agent tool restrictions are on the roadmap.

What if an MCP server is slow?

MCP calls have a 30-second timeout. If a server doesn’t respond in time, the agent will gracefully handle the error and continue the conversation.

Can I build my own MCP server?

Yes! Follow the MCP specification to build a compatible server, then add it as a custom server.

Get Started

Features

Guides

Integrations & MCP

Overview

OAuth Integrations

Available Integrations

HubSpot

Slack

Cal.com

Connecting an Integration

HubSpot Tools

Slack Tools

Calendar Tools

MCP Server Catalog

Featured Servers

Connecting a Catalog Server

Full Catalog

Custom MCP Servers

Adding a Custom Server

Requirements

Authentication Options

Example MCP Server Response

How Agents Use Tools

Tool Naming

Preview Mode

Built-in Tools

Managing Integrations

Check Status

Disconnect

Refresh Tokens

Tool Execution Logs

API Access

List Available Tools

Execute a Tool

Security

FAQ

Get Started

Features

Guides

​Overview

​OAuth Integrations

​Available Integrations

HubSpot

Slack

Cal.com

​Connecting an Integration

​HubSpot Tools

​Slack Tools

​Calendar Tools

​MCP Server Catalog

​Featured Servers

​Connecting a Catalog Server

​Full Catalog

​Custom MCP Servers

​Adding a Custom Server

​Requirements

​Authentication Options

​Example MCP Server Response

​How Agents Use Tools

​Tool Naming

​Preview Mode

​Built-in Tools

​Managing Integrations

​Check Status

​Disconnect

​Refresh Tokens

​Tool Execution Logs

​API Access

​List Available Tools

​Execute a Tool

​Security

​FAQ

Overview

OAuth Integrations

Available Integrations

Connecting an Integration

HubSpot Tools

Slack Tools

Calendar Tools

MCP Server Catalog

Featured Servers

Connecting a Catalog Server

Full Catalog

Custom MCP Servers

Adding a Custom Server

Requirements

Authentication Options

Example MCP Server Response

How Agents Use Tools

Tool Naming

Preview Mode

Built-in Tools

Managing Integrations

Check Status

Disconnect

Refresh Tokens

Tool Execution Logs

API Access

List Available Tools

Execute a Tool

Security

FAQ