Skip to content

mcp-server.md

Latest commit

 

History

History
116 lines (81 loc) · 3.41 KB

mcp-server.md

File metadata and controls

116 lines (81 loc) · 3.41 KB

MCP Server (tc-mcp)

tc-mcp is a Model Context Protocol server that exposes TenantCloud data to AI agents like Claude Desktop, Claude Code, and Cursor.

Installation

Download the binary for your platform from GitHub Releases:

Platform Asset
Windows x64 tc-mcp-win-x64.zip
Windows ARM64 tc-mcp-win-arm64.zip
macOS x64 tc-mcp-osx-x64.zip
macOS ARM64 tc-mcp-osx-arm64.zip
Linux x64 tc-mcp-linux-x64.zip
Linux ARM64 tc-mcp-linux-arm64.zip
Portable (.NET 10) tc-mcp-any.zip

Each zip contains the executable (tc-mcp.exe on Windows, tc-mcp on macOS/Linux). Platform-specific builds are self-contained (no .NET runtime required). The portable build requires .NET 10 — run with dotnet tc-mcp.dll mcp.

Authentication

Before using the MCP server, authenticate with TenantCloud:

tc-mcp login

This opens a browser window for you to sign in. Tokens are stored in the OS secure credential store (DPAPI on Windows, Keychain on macOS, Secret Service on Linux).

To remove stored credentials:

tc-mcp logout

Auto-configuration

# For Claude Desktop
tc-mcp install claude-desktop

# For Claude Code
tc-mcp install claude-code

What install does

Claude Desktop — patches the config JSON at:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code — runs claude mcp add --transport stdio tc-mcp -- <exePath> mcp

Manual configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tc-mcp": {
      "command": "/path/to/tc-mcp",
      "args": ["mcp"]
    }
  }
}

Claude Code

claude mcp add --transport stdio tc-mcp -- /path/to/tc-mcp mcp

Cursor / other MCP clients

Use stdio transport with the tc-mcp binary path as the command and mcp as the first argument.

Available tools

Tool Description Filters
get_user_info Current signed-in user profile —
list_contacts Tenants, professionals, etc. role, maxResults
list_properties Rental properties maxResults
list_units Rental units propertyId, occupancy, maxResults
list_transactions Financial transactions tenantId, propertyId, unitId, status, category, maxResults
list_leases Lease agreements propertyId, unitId, status, maxResults

Available resources

URI Description
tc://guide Tool usage guide — entities, fields, filters, and how to resolve names to IDs

Authentication

On first use, tc-mcp will attempt to authenticate via:

  1. Stored token — loaded from the OS secure credential store (DPAPI / Keychain / Secret Service)
  2. Running browser — extracts tokens from a Chromium browser tab open on app.tenantcloud.com
  3. Interactive login — launches a browser window for you to sign in

Tokens are cached and refreshed automatically. See Authentication for details.

Example questions to ask your AI agent

  • "Who are my tenants?"
  • "What properties do I have?"
  • "Which units are vacant?"
  • "Show me overdue transactions"
  • "List active leases for property 12345"
  • "What is the total rent balance?"