Home

MCP Server Documentation

Lots Engage MCP Server

Connect AI agents like Claude and Cursor to Lots Engage using the Model Context Protocol

Quick Information
MCP Endpoint
https://engage.lotsmcp.com/mcp
Available Tools
14 tools
Authentication
OAuth 2.1 with PKCE
Setup Instructions
Configure your MCP client to connect to Lots Engage

Add this configuration to your Cursor settings:

{
  "mcpServers": {
    "lotsengage": {
      "url": "https://engage.lotsmcp.com/mcp"
    }
  }
}

Steps:

  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Search for "MCP Servers"
  3. Click "Edit in settings.json"
  4. Add the configuration above
  5. Restart Cursor
  6. Cursor will automatically discover OAuth endpoints and handle authentication
Authentication
This server implements OAuth 2.1 with PKCE for secure authentication
OAuth 2.1 with PKCE (S256)

Most modern MCP clients will automatically discover and handle the OAuth flow. The server uses OAuth 2.1 with PKCE (S256) for secure authentication.

OAuth Discovery
https://engage.lotsmcp.com/.well-known/oauth-authorization-server
Authorization Endpoint
https://engage.lotsmcp.com/api/oauth/authorize
Token Endpoint
https://engage.lotsmcp.com/api/oauth/token

How it works:

  1. Clients automatically discover OAuth endpoints
  2. Users are redirected to authenticate via browser
  3. Authorization code is exchanged for access token
  4. Bearer token is used for all MCP requests
Available Tools
14 MCP tools available for Lots Engage. Use these tool names when calling the MCP server.

opportunities

Get opportunity
Get one thread, its current reply, and whether it was posted.
Import opportunities
File up to 50 threads. Each row reports created, updated, or rejected. A repeated URL updates the same thread and does not wipe a reply already handed, approved, or posted.
List opportunities
List threads in a project. Filter with platform, fit, or status.
Save opportunity
File one community thread. The same URL updates the same row and does not reopen a thread that is already handed, approved, or posted. platform is reddit, quora, hackernews, forum, facebook_group, or other. fit is strong, partial, or poor. rules is answer_only, disclose_ok, promo_banned, or unknown.
Skip opportunity
Mark a thread as not worth an answer. A skipped thread is not drafted again. reason is required.

projects

Create engage project
Create the product to represent in communities, or return the existing project when this owner already used that name. A repeat does not overwrite the saved offer or disclosure line.
Get engage project
Get one product plus counts of ready replies, handed replies, approved replies, and posted threads.
List engage projects
List the products this owner represents in communities.
Update engage project
Change the product name, site, offer summary, or disclosure line.

queue

Get engage queue
Start every community run here. Returns replies handed to the user, replies approved but not posted, ready replies not yet handed, then at most 3 found threads worth drafting. Skipped, declined, posted, and poor-fit threads are omitted.

replies

Mark reply handed
Record that the current ready reply was given to the user. reply_id, when sent, must be that current reply.
Mark thread posted
Record the live URL after the reply is public. posted_by=agent is rejected unless this reply was approved. posted_by=user records a post the person made. A second call returns the original URL.
Record reply decision
Record the user's decision on the current ready reply. decision is approved or declined.
Save reply
Save the prepared reply for one thread. A product mention requires discloses_ownership and the project disclosure line. promo_banned rejects a product mention. The previous ready reply is superseded.
REST API DocumentationGet API Key