SmartAgent CRM — MCP Server

Connect your AI assistant to the SmartAgent real estate CRM.

smartagent.ru · Support · Privacy Policy

---

What is this?

SmartAgent is a CRM built specifically for real estate agencies. It handles the daily work of a brokerage: incoming leads, agent tasks, sales pipelines, property listings and their publication to classified portals, client notes, saved searches, and team management.

Note on audience: SmartAgent is a Russian-language product serving real estate agencies in Russia and the CIS. The CRM interface, tool descriptions and returned data are in Russian. This README is in English because MCP catalogs and clients are international — but if you are not a SmartAgent customer, this server will not be useful to you.

This repository publishes the MCP (Model Context Protocol) server manifest for SmartAgent. The server lets any MCP-compatible AI assistant — Claude Desktop, Claude Code, or your own agent — read and act on your CRM data on your behalf: find leads, create tasks, move deals through the pipeline, look up property listings, leave notes, and more.

Typical things you can ask your assistant once it's connected:

• "What leads came in this week that nobody has called yet?"
• "Create a follow-up task for tomorrow on this deal and leave a note about the call."
• "Show me the two-bedroom listings we have in this district under 15M."
• "Which deals are stuck in the 'viewing scheduled' stage for more than 10 days?"

This repository contains only the public manifest, icon and documentation. The CRM and the MCP server implementation are closed source and are not published here.

Server details

Endpoint	https://mcp.smartagent.ru/
Transport	Streamable HTTP (MCP revision 2025-06-18)
Authentication	API key, sent as a header
Tools available	200+
Hosting	Fully hosted by SmartAgent — nothing to install or self-host
Access	SmartAgent corporate plan only

Access and limits

MCP access is part of the SmartAgent corporate plan. Keys issued on trial, free or regular plans are rejected with 403.

Limit	Value
Requests	60 per minute, 1,000 per hour, 5,000 per day (per company)
Listing records returned	50,000 per day (per company)
Owner phone numbers	within the phone-reveal limit of your plan

To get the corporate plan, contact us (see Support & contacts).

Getting an API key

1. Log in to your SmartAgent account at smartagent.ru (the company must be on the corporate plan).
2. Open Menu → API keys in the CRM.
3. Create a key and copy it. It looks like sa_mcp_ followed by 64 hex characters.

The key carries the permissions of the account it belongs to and gives access to your company's CRM data — treat it like a password. Don't commit it to a repository, don't paste it into shared chats, and revoke it in the same screen if it leaks.

Connecting your MCP client

The server is remote — there is nothing to install. Point your client at the URL and pass the key in the Authorization header.

Claude Desktop / Claude Code

Add this to your MCP client configuration (for Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "smartagent": {
      "type": "http",
      "url": "https://mcp.smartagent.ru/",
      "headers": {
        "Authorization": "Bearer sa_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

Restart the client afterwards. The SmartAgent tools should then appear in the tool list.

Clients without native remote-server support

If your client can only launch local (stdio) servers, bridge to the remote endpoint with mcp-remote:

{
  "mcpServers": {
    "smartagent": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.smartagent.ru/",
        "--header", "Authorization: Bearer sa_mcp_YOUR_KEY_HERE"
      ]
    }
  }
}

Authentication notes

The API key is accepted in any of these forms:

Header	Value
Authorization	Bearer sa_mcp_...
Authorization	sa_mcp_... (the Bearer prefix is optional)
X-Api-Key	sa_mcp_...

Use whichever your client supports. Authorization: Bearer ... is the recommended default.

What the tools cover

200+ tools, grouped by the CRM entity they work with:

Category	What it covers
Leads	Incoming leads and clients — search, read, create, update, assign, track status
Tasks	Agent to-dos and reminders — create, reschedule, complete, filter by assignee and due date
Sales pipelines	Deals and their stages — move deals along the funnel, inspect stage history
Property listings	Real estate objects and their classified ads — search the base, read details, manage publication
Notes & attachments	Comments, call notes and files attached to leads, deals and listings
Saved searches	Client search requests stored in the CRM and matching against the property base
Tags & labels	Categorising and filtering records with the company's own labels
Buildings & calls	Building/complex lookups and call records linked to leads
Ad platforms	Publishing and syndication settings for listings across classified portals (Avito, CIAN, etc.)
Reports	Aggregated CRM reports (e.g. competitor counts for a listing)
Company & employees	Company profile, team members, roles and assignment

Tool names and parameters are discovered automatically by your MCP client via tools/list — there is nothing to memorise. Each tool is described in Russian, matching the CRM's own terminology.

Security & privacy

• Access is scoped to the account that issued the API key: the assistant sees your company's data and nothing else.
• Keys can be revoked at any time in Menu → API keys.
• Data handling is covered by our Privacy Policy.
• Give the key only to AI clients you trust — an assistant with this key can modify CRM records, not just read them.

Support & contacts

We answer in Russian and English.

Channel
🌐 Website	smartagent.ru
✉️ Email	info@smartagent.ru
☎️ Phone	+7 (495) 988-93-91
💬 WhatsApp	+7 (495) 988-93-91
✈️ Telegram support bot	@SmartAgentSupportBot
📣 Telegram channel	@SmartAgent_ru
🅜 MAX support bot	max.ru/id7725737972_bot

Found a bug in the MCP server or want a tool that doesn't exist yet? Open an issue in this repository or write to info@smartagent.ru.

License

The contents of this repository (manifest, icon, documentation) are released under the MIT License. The SmartAgent CRM and the MCP server implementation itself are proprietary and are not covered by this license.

---