SmartAgent CRM MCP server

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

Access and limits

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

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 samcp 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: claudedesktopconfig.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

Shortened. The full README is on GitHub.