Home

MCP Server Documentation

LotsTech MCP Server

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

Quick Information
MCP Endpoint
https://api.lotstech.com/mcp
Available Tools
12 tools
Authentication
OAuth 2.1 with PKCE
Setup Instructions
Configure your MCP client to connect to LotsTech

Add this configuration to your Cursor settings:

{
  "mcpServers": {
    "lotstech": {
      "url": "https://api.lotstech.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://api.lotstech.com/.well-known/oauth-authorization-server
Authorization Endpoint
https://api.lotstech.com/api/oauth/authorize
Token Endpoint
https://api.lotstech.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
12 MCP tools available for LotsTech. Use these tool names when calling the MCP server.

billing

Acquire Resource Entitlement
Atomically acquire a named resource and assess its current UTC service day.
Create Checkout Link
Create a Polar checkout link for product purchase. Returns a checkout URL where users can complete payment. Supports monthly, yearly, and one-time (lifetime) billing cycles. For credits products with custom pricing ("Pay What You Want"), pass custom_amount to pre-fill the amount. The checkout link includes user email pre-fill and custom metadata for tracking.
Create Customer Portal Link
Create a Polar customer portal link for the signed-in user's paid plan, where they can upgrade, downgrade, switch billing cycle or cancel. Returns { available: false } for gift or credits-only accounts.
Get Project Products
Get all available products for a specific project (SaaS). Returns product listings with pricing details for monthly, yearly, and one-time purchases.
Get User Subscription
Get the authenticated user's active subscription for a specific project. Returns subscription status, billing cycle, and product details.
List Resource Entitlements
List active resource holdings owned by the authenticated payer.
Project Resource Entitlements
Project every held resource against the contract active at a timestamp; use for cancellation and renewal previews.
Quote Resource Entitlement
Quote plan coverage and credit-funded overflow without changing state.
Release Resource Entitlement
Release a named resource; future daily billing stops and the product resource is not deleted.

credits

Deduct User Credits
Deduct credits from the authenticated user's balance for feature usage. Validates sufficient balance before deduction. Automatically calculates balance_after and sets transaction_type to 'usage'. Supports reference_type and reference_id for linking to external records.
Get Credit History
Get the authenticated user's credit transaction history with pagination. Can optionally filter by project_id to show only transactions for a specific SaaS. Returns all credit transactions including purchases, usage, refunds, bonuses, and admin adjustments. Shows which project consumed credits and when.
Get User Credits
Get the authenticated user's current credit balance. Credits are shared across all LOTS products and never expire.
REST API DocumentationGet API Key