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/mcpAvailable 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:
- Open Cursor Settings (Cmd/Ctrl + ,)
- Search for "MCP Servers"
- Click "Edit in settings.json"
- Add the configuration above
- Restart Cursor
- 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-serverAuthorization Endpoint
https://api.lotstech.com/api/oauth/authorizeToken Endpoint
https://api.lotstech.com/api/oauth/tokenHow it works:
- Clients automatically discover OAuth endpoints
- Users are redirected to authenticate via browser
- Authorization code is exchanged for access token
- 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
lotstech_create_checkout_linkCreate 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.
lotstech_create_customer_portal_linkCreate 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.
lotstech_get_project_productsGet Project Products
Get all available products for a specific project (SaaS). Returns product listings with pricing details for monthly, yearly, and one-time purchases.
lotstech_get_user_subscriptionGet User Subscription
Get the authenticated user's active subscription for a specific project. Returns subscription status, billing cycle, and product details.
lotstech_entitlement_resourcesList Resource Entitlements
List active resource holdings owned by the authenticated payer.
lotstech_entitlement_projectionProject Resource Entitlements
Project every held resource against the contract active at a timestamp; use for cancellation and renewal previews.
lotstech_entitlement_quoteQuote Resource Entitlement
Quote plan coverage and credit-funded overflow without changing state.
lotstech_entitlement_release_v2Release Resource Entitlement
Release a named resource; future daily billing stops and the product resource is not deleted.
credits
lotstech_deduct_user_creditsDeduct 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.
lotstech_get_credit_historyGet 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.
lotstech_get_user_creditsGet User Credits
Get the authenticated user's current credit balance. Credits are shared across all LOTS products and never expire.