LotsDirectory for
your AI agent.
Publish and update your LotsDirectory listing, answer buyer questions, and with Directory Pro work through a verified list of launch directories using a ready submission packet, recording each result where you and your agent both see it.
https://api.lots.directory/mcpAsk your agent, for example.
Once LotsDirectory is connected, plain requests like these work.
- “Update our listing with this week's release notes.”
- “Which directories are next on our submission list?”
- “Record that our Uneed submission went live today.”
Connect in two minutes.
Claude
Settings → Connectors → Add custom connector. Paste the URL, connect, and sign in with your Lots account.
ChatGPT
Settings → Apps & Connectors → Advanced → turn on Developer mode, then Create a connector with the URL and sign in.
Claude Code
claude mcp add --transport http lots-directory https://api.lots.directory/mcp
Codex
codex mcp add lots-directory --url https://api.lots.directory/mcp
Cursor, Windsurf and others
{
"mcpServers": {
"lots-directory": {
"url": "https://api.lots.directory/mcp"
}
}
}Cloud agents without MCP
Give the agent https://api.lots.directory/docs.md and an API key from lotstech.com/api. It calls the REST API with Authorization: Bearer <key>.
Every server uses OAuth: your agent acts as you, inside your own roles and workspaces. You can disconnect it at any time from the app.
34 tools, also REST endpoints.
Each tool is available over MCP and as a REST endpoint under https://api.lots.directory/api/v1/lotsdirectory.
Answer a question
PATCH /questions/:id
Answer a question on a listing you own.
Complete product image upload
POST /images/uploads/complete
Verify actual uploaded bytes and reserved size/type before attaching an image. Returns URL; at most 8 distinct images per listing including logo and cover.
Confirm Directory Pro payment
Confirm a Directory Pro payment after checkout return. Activates only a paid order for this product and owner. Repeating it does not extend promotion.
Create product image upload
POST /images/uploads
Upload a local image: obtain a 15-minute signed PUT URL, upload bytes, then complete_listing_image_upload. Exact size, at most 2 MB. JPEG/PNG/WebP/GIF only.
Delete unused product image
POST /images/delete
Delete an uploaded image you own. Remove it from the listing and save first. Frees an unattached upload slot.
Get category
GET /public/categories/:slug
Get a category with its published products.
Get Directory offer
Read the current Directory offer, price, image limits, verified directory count, and Domain Rating disclosure. Price is present only when $20 checkout is actually enabled.
Get Domain Rating history
Read Domain Rating history for a Directory Pro product you own. Unknown is not zero. Includes the next refresh allowance.
Get my product
GET /listings/:id
Get full details of a listing you own (for editing).
Get my profile
GET /me/profile
Get the authenticated maker profile.
Get one directory
Read one verified directory and the progress saved for a product you own, including its submit link. Requirements and fees are not invented.
Get product
GET /public/listings/:slug
Get a single published product by slug.
Get product analytics
GET /listings/:id/analytics
Read views, clicks, and a view-to-click ratio for a Directory Pro product you own. There is no source attribution. Free products receive PRO_REQUIRED.
Get product entitlements
Read Free or Directory Pro status, image allowance, promotion dates, and capabilities for a product you own. Does not reveal another owner's product.
Get product preparation
Read the reusable product preparation packet for a Directory Pro product you own. format text or markdown returns copyable content. Missing fields stay missing. Nothing is invented.
List categories
GET /public/categories
List all directory categories.
List directory progress
List saved directory progress for a product you own. format=text returns a copyable summary. Counts include directories that have not been started.
List incoming questions
GET /me/questions
List questions asked on your products (to answer).
List my products
GET /me/listings
List listings owned by the authenticated user.
List notifications
GET /me/notifications
List the authenticated user notifications.
List products
GET /public/listings
List published directory products with filters and sorting.
List verified directories
List verified directories and this product's saved progress. This records nothing and does not submit a form. Filters: search, category, pricing, link type, minimum DR, progress state, and relevant=true.
Manage product publication
Publish, unlist, keep as a private draft, or schedule a listing you own. The result states whether it is public, private, scheduled, or awaiting review.
Mark notification read
POST /me/notifications/read
Mark one or all notifications read.
Publish a product update
POST /listings/:id/updates
Publish an update on a Directory Pro product you own. Free products cannot post updates. Questions stay free.
Record a Domain Rating snapshot
Save a Domain Rating you or your agent observed. Value is an integer from 0 to 100. Omit the value instead of recording 0 when it is unknown. observed_at cannot be in the future.
Record directory progress
Record or update progress for one directory on a product you own. This does not submit the form. submitted needs a receipt or note. live needs the public listing URL. needs_action needs the next owner action. An identical retry does not change the revision.
Search products
GET /public/search
Typeahead search across published products.
Start Directory Pro checkout
Start a $20 one-time checkout for one product you own. Refuses unless the server offer is enabled and the billing product is $20 USD. Does not submit the product to other directories.
Submit a product
POST /listings
Create a product listing you own. publication: publish (default), draft to keep it private while preparing, or schedule with scheduled_publish_at. Free includes 2 distinct images, Directory Pro 8; logo, cover, gallery and thumbnails count once per URL; each image at most 2 MB.
Update a product
PATCH /listings/:id
Update a product you own. A free product can keep a grandfathered image set only when the URLs do not change. Any real image change must fit 2 images, or 8 after Directory Pro. Do not send is_pro or an image limit; the server decides.
Update maker profile
PATCH /me/profile
Update the authenticated user maker profile.
Update product preparation
Save preparation overrides, variants, or notes for a Directory Pro product you own. Send null or blank to clear one override. Pass expected_revision to avoid overwriting a newer save. Variants over a character limit are kept and warned, not truncated.
Upload product image
POST /images
Upload an image URL or base64 image to Directory storage. Maximum 2 MB, JPEG/PNG/WebP/GIF. Free products can use 2 distinct images and Directory Pro products can use 8, including logo and cover. The same URL counts once. Pass listing_id so the server enforces that product limit. At most 2 uploads may remain unattached.
Questions, answered.
What is the LotsDirectory MCP server URL?
https://api.lots.directory/mcp. Add it as a remote MCP server (custom connector) in your AI agent and sign in with your Lots account.
Which agents work with LotsDirectory?
Claude, ChatGPT (developer mode), Claude Code, Codex, Cursor, Windsurf and any other client that supports remote MCP with OAuth. Agents without MCP use the REST API with an API key.
Where are the LotsDirectory API docs?
https://api.lots.directory/docs.md: Markdown written so an AI agent can read it. Requests go to https://api.lots.directory/api/v1/lotsdirectory with Authorization: Bearer <your key>.
How do I get a LotsDirectory API key?
Use Generate key on this page or at lotstech.com/api. Sign in with your LotsTech account, name the key and copy it once. You can revoke it there at any time.
Does MCP or API access cost extra?
No. It is included with LotsDirectory. You pay only for LotsDirectory's own plan or usage, and your AI provider bills its own usage.