get_schemaLABSCO SUMMARY
OAuth lets you grant per project; a static key does not.
Take the OAuth path where your client supports it — you approve which projects the integration may touch, and revoke it from the same admin page. Destructive operations ask first: deletes, full block replacements, URL structure changes and script overwrites all prompt for confirmation. Rate limits are per plan, 60 requests a minute on Growth and 300 on Pro, which is why bulk imports should go through the bulk tool rather than a loop.
What it is
The management interface for a Listable directory site, exposed as tools. Every site-management operation — listings, taxonomy, page blocks, forms, settings — is callable, so building a directory becomes something you describe rather than click through.
What you get
- About 47 tools by the README's count, grouped by area and covering projects, items, categories, custom fields, pages and blocks, forms, settings, redirects and uploads
- Listings with full CRUD plus
bulk_create_items, which takes up to 100 listings in a single call - Categories with trees and conflict inspection; custom fields in text, number, date, url, checkbox, select, phone, address and image types
- Page blocks and global block areas — homepage hero, homepage main, detail page, category pages
- Settings for the menu, scripts, SEO and URL structure, plus image and file uploads for use in listings and pages
get_schemais called first by design, so edits use your site's real custom fields and block types
Requirements
Two routes. If your client speaks HTTP MCP, add https://app.get-listable.com/api/v1/external/mcp and log in through OAuth — Claude Code takes claude mcp add --transport http; access tokens last 1 hour and refresh silently for 1 month. For stdio-only clients such as Claude Desktop, install the npm package listable-mcp, version 0.1.1, run it as npx -y listable-mcp, and set LISTABLE_API_TOKEN to a key created in your Listable admin. LISTABLE_MCP_URL overrides the upstream endpoint for self-hosted or staging setups.
Setup effort
One command plus a key — npx -y listable-mcp, then supply credentials
USE CASES
01
Filling a new directory with its first hundred listings
Import in batches of up to 100 per call rather than one create at a time.
02
Restructuring the taxonomy of an existing site
Work through category trees and inspect conflicts before committing the change.
03
Setting up SEO and the URL structure
Set meta titles and descriptions and change the URL structure — the destructive part asks first.
04
Building a page out of blocks
Read a page's blocks, update them, and manage the global areas that appear across the site.
2 tools
Listed in project docs. Your client may show a different list.
bulk_create_itemsBEFORE YOU INSTALL
What to know first
Tools you get
The project says 47; its docs name 2.
Requires
- npx on PATH
- LISTABLE_API_TOKEN in your environment
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y listable-mcpHosted endpoint
ENDPOINT URL
https://app.get-listable.com/api/v1/external/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude.ai
Settings → Integrations → Add custom integration
Paste https://app.get-listable.com/api/v1/external/mcp
Claude.ai bounces you to Listable to log in and pick the projects the integration may access
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport http listable https://app.get-listable.com/api/v1/external/mcpCursor
In Settings → MCP, add an HTTP server
Name: listable
URL:
CURSOR · URL
https://app.get-listable.com/api/v1/external/mcpCursor will trigger the OAuth flow on first connect
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"listable": {
"command": "npx",
"args": [
"-y",
"listable-mcp"
],
"env": {
"LISTABLE_API_TOKEN": "<YOUR_LISTABLE_API_TOKEN>"
}
}
}
}
