SmallForce MCP Server
The SmallForce MCP (Model Context Protocol) server lets AI agents manage your entire business from a single integration — social media publishing, CRM contacts, inbox messaging, Google reviews, and AI call analytics.
What is MCP?
Model Context Protocol is an open standard that lets AI assistants call tools and access data from external services. Instead of copying data into prompts, the AI connects directly to your SmallForce account and takes actions on your behalf.
Why use SmallForce MCP?
- 22 tools across social media, CRM, inbox, reviews, and calls
- Single API key — one key gives the AI access to your full SmallForce account
- Stateless and fast — no sessions, no webhooks, just POST requests
- Works everywhere — Cursor, Claude, ChatGPT, Windsurf, Antigravity, VS Code Copilot, Cline, and any MCP-compatible client
Quick setup
1. Get your API key
- Download the SmallForce app from the App Store or visit smallforcehq.com/download
- Open the app → go to Settings
- Create an API key — keys start with
sf_sk_live_
2. Connect your client
The SmallForce MCP server is hosted at:
https://mcp.smallforcehq.com/mcp
Choose your client for setup instructions:
| Client | Guide |
|---|---|
| Cursor | IDE with AI-powered coding |
| Claude Desktop | Anthropic’s desktop app |
| ChatGPT | OpenAI’s chat interface |
| Windsurf | Codeium’s AI IDE |
| Antigravity | Gemini-powered coding agent |
| VS Code Copilot | GitHub Copilot in VS Code |
| Cline | Autonomous AI agent for VS Code |
3. Start using tools
Once connected, your AI agent has access to all 22 SmallForce tools. Ask it to:
"List my connected Instagram accounts"
"Create a social post saying 'New product launch! 🚀' on all accounts"
"Show me unread inbox conversations"
"Find all 1-star Google reviews that need a reply"
"List CRM contacts added this week"
Authentication
Every request requires a Bearer token in the Authorization header:
Authorization: Bearer sf_sk_live_your_api_key_here
The backend validates the key and scopes all operations to your organization. No data leaks across accounts.
Available tools
See the complete tools reference for all 22 tools with parameters and descriptions.
| Category | Tools | What they do |
|---|---|---|
| Organization | 1 | View org details, credits, plan |
| Agentic Social Media | 7 | Accounts, create/update/list posts, upload media |
| Inbox | 3 | List conversations, read messages, send replies |
| Google Reviews | 2 | List reviews, reply to reviews |
| Contacts & CRM | 7 | Full CRUD, pipeline, custom fields, analytics |
| Call Analytics | 2 | List calls, get transcripts and AI analysis |
Architecture
The SmallForce MCP server uses Streamable HTTP transport — the modern MCP transport protocol:
- Endpoint:
POST https://mcp.smallforcehq.com/mcp - Transport: Streamable HTTP (stateless)
- Auth: Bearer token from
Authorizationheader - Format: JSON-RPC 2.0
No SSE, no WebSockets, no session management. Each request is independent and authenticated.