MCP Connector

Connect PropelAgent to Claude Desktop and claude.ai via the Model Context Protocol

Quick Start

  1. Open Claude — Go to Settings → MCP Connectors in Claude Desktop or claude.ai.
  2. Add connector — Enter the endpoint URL:
    https://www.propelagent.studio/api/mcp
  3. Authorize — You will be redirected to PropelAgent to log in and grant access. OAuth 2.0 with PKCE is used automatically.
  4. Start using — Ask Claude to check your leads, review conversations, create forms, or manage your CRM.

How It Works

PropelAgent implements the Model Context Protocol (MCP) using Streamable HTTP transport. Claude connects to your PropelAgent account through a secure OAuth 2.0 flow, giving it access to your business data — leads, conversations, forms, and CRM — directly within the chat interface.

Protocol: MCP 2025-11-25 (Streamable HTTP)
Auth: OAuth 2.0 + PKCE with Dynamic Client Registration
Session management via MCP-Session-Id header
Origin validation for DNS rebinding protection

Available Tools (25)

Read-only (17 tools)

ToolDescription
get_leadsList and filter leads with pagination
get_conversationsList conversations with filters
get_conversation_messagesGet messages for a conversation
get_conversation_historyFull conversation thread
get_unanswered_conversationsConversations awaiting response
get_usage_statsBot usage analytics
get_agent_summaryAgent performance summary
get_popular_searchesMost popular user searches
list_formsList all PropelForms
get_formGet form details by ID
get_form_submissionsGet form submissions
inspect_pageInspect a public bot page
screenshot_pageScreenshot a bot page
crm_statusCRM pipeline summary
crm_list_companiesList CRM companies
crm_list_dealsList CRM deals
crm_find_contactSearch CRM contacts

Write (8 tools)

ToolDescription
create_formCreate a new PropelForm
update_formUpdate form fields and settings
share_formGenerate a shareable form link
create_test_submissionSubmit test data to a form
delete_test_submissionRemove a test submission
update_submission_statusUpdate submission status
crm_create_leadCreate a new CRM lead
crm_create_dealCreate a new CRM deal

Example Prompts

"Show me my latest leads from this week"
"Are there any unanswered conversations?"
"Create a contact form for my landing page"
"Give me a summary of my CRM pipeline"
"What are the most popular searches on my bot?"

Security

  • OAuth 2.0 with PKCE — no client secrets stored on the client side.
  • Tokens scoped to your account only — Claude can never access other users' data.
  • All tool results are paginated (max 50-100 items) to prevent data over-exposure.
  • Write operations require explicit confirmation within Claude.
  • You can revoke access at any time from your PropelAgent settings.

Requirements

  • An active PropelAgent account (any plan).
  • Claude Desktop app or claude.ai with MCP support.

Support

Need help setting up? Contact us at [email protected] or visit propelagent.studio.