Skip to content
Start free

Platforms

AI agents (MCP)

Let Claude, ChatGPT, Cursor, and other AI agents set up and manage your search through Findlane's MCP server.

Findlane has an MCP server, so AI agents can set up and look after your search. Connect it once and ask, for example, "Add Findlane search to this app". The agent creates an index, loads your records, chooses the settings, tests some searches, allows your site's origin, and writes the search UI.

Connect

The server's address is https://api.findlane.dev/mcp. When an agent first connects, Findlane opens in your browser: sign in, choose the workspaces the agent can manage, and allow it.

Claude

Add Findlane from Claude's connector directory, or find it under Connectors in Claude's settings. Findlane opens for you to sign in and choose the workspaces Claude can manage.

ChatGPT

Add Findlane from ChatGPT's plugin directory, or find it under Plugins in ChatGPT. Findlane opens for you to sign in and choose the workspaces ChatGPT can manage.

Claude Code

claude mcp add --transport http findlane https://api.findlane.dev/mcp

Then run /mcp in Claude Code, choose findlane, and sign in.

Cursor

Add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

{
  "mcpServers": {
    "findlane": { "url": "https://api.findlane.dev/mcp" }
  }
}

VS Code

Add the server to .vscode/mcp.json:

{
  "servers": {
    "findlane": { "type": "http", "url": "https://api.findlane.dev/mcp" }
  }
}

Other clients work too if they support remote MCP servers (Streamable HTTP) with OAuth.

Clients and registries that discover servers by domain find this one through findlane.dev's AI Catalog, https://findlane.dev/.well-known/ai-catalog.json, which links its server card. There is also an agent skill for adding Findlane search to an app, listed at https://findlane.dev/.well-known/agent-skills/index.json, and a summary of how agents authenticate at https://findlane.dev/auth.md.

What agents can do

Tool
list_workspaces, get_workspace, list_indexesYour workspaces, their plans and usage, and their indexes.
create_index, get_index, delete_indexCreate, inspect, and delete indexes. get_index lists every field with its type, and until the settings are first changed, suggests settings for the index's kind of data.
set_index_appearanceAn index's icon and color in the dashboard.
set_index_kindWhat an index's records are: products, docs, articles, listings, or other.
create_subindexAdd a subindex to an index, such as its categories or pages.
get_records, upsert_records, delete_recordsRead records, and write or delete up to 100 a call.
create_upload_keyA write key for one index that expires in an hour, with commands to upload a file of records.
get_writesWhat came into an index: when data last arrived and last changed anything, each source, writes refused with their reasons, and the latest operations. Agents use it to check what an upload did.
update_settings, wait_for_settingsChange any search setting, such as facets, sorts, synonyms, or rules.
compare_settingsPreview a settings change before saving it: the search tests it would break, and the searches whose results change. Agents run it before update_settings.
get_search_tests, set_search_testsAn index's search tests: searches that must keep working, such as one the agent just fixed.
searchTry searches, filters, facets, and sorts, and explain why each result matched and ranks where it does. It says which rules fired, and can search without them. A search that finds nothing shows its related results.
set_allowed_origins, set_public_policy, set_public_limits, rotate_public_idBrowser search access.
set_image_hostsOptimized images on paid plans: the hosts whose record images are resized and sent as WebP, and the field placeholders are made from. get_index shows them, the hosts found in the records, and the month's new copies.
set_trusted_addresses, unblock_visitorThe workspace's trusted addresses, and letting a heavy visitor back in for the day.
list_lists, save_list, delete_list, refresh_listsAn index's lists: rows of products and menus of values for its pages, what each holds, and setting them up.
get_recommendationsA product's recommendations, for indexes with the add-on.
get_search_analyticsTop searches, and searches that found nothing.
get_no_result_fixes, apply_no_result_fixesWhy searches found nothing, with a checked fix for typos and other words, and adding those fixes.
get_rule_hitsHow many searches each of an index's rules fires on, and on which queries.
get_facet_matchesA facet field's values as facet matches see them: names, counts, and whether each is hidden, for going through them.
list_merchandising, get_merchandising, set_merchandising, stop_merchandisingMerchandising: which products come first on a category page or a search, hidden products, a banner and a campaign's times, with the page's first products as shoppers see them.
list_images, upload_image, delete_image, get_banner_statsBanner images hosted by Findlane, uploaded from an address or as data, and each banner's shown, clicks and click rate.
get_feed, check_feed, connect_feed, run_feed, disconnect_feedAn index's product feed: what a feed holds before connecting it, connecting and running it, its runs, and why items were refused.
preview_query_suggestions, rebuild_query_suggestionsWhat an index's query suggestions offer for a prefix, and with the box empty, and when its list was last built; and building the list again now.
get_related_results, calibrate_related_resultsWhether an index's related results are on, how many records are embedded, the floor with examples from its calibration, and the month's spend; and calibrating the floor again.
start_ab_test, get_ab_test, end_ab_testA/B tests of search settings: test a change on a share of shoppers, compare the groups' clicks, add-to-carts and orders, then keep or apply it.
get_learned_rankingWhat learning from clicks learned for an index: each search's products, best first, with their clicks and sales, and what's left out.
get_product_analyticsAn index's most viewed products with their events, and products viewed but rarely bought.
get_search_revenueAn index's revenue from search: orders and add-to-carts of products found through search, per query and per product.
get_sales_by_filterAn index's sales by filter value: which facet values lead to add-to-carts and orders.
get_event_analyticsViews, clicks, add-to-carts and orders per day and per index, the latest events, and any that were refused and why.
list_api_keys, create_api_key, update_api_key, delete_api_keyAPI keys for your servers. update_api_key changes a key's name, scopes, index or searches a minute and keeps its secret.
list_signing_keys, revoke_signing_keySigning keys for logged-in visitors. They're made only in the dashboard, shown once to you.
search_docs, read_docsSearch these docs by section, or read a page as Markdown.

It also has two prompts. In Claude Code, run them as /mcp__findlane__add-search and /mcp__findlane__fix-no-results:

  • add-search sets up an index from your project's data for the searches that must work, saves them as search tests, and builds the search UI.
  • fix-no-results starts from why each search found nothing, adds the fixes that make sense, and fixes what else settings can, such as missing synonyms.

What to tell an agent about your shoppers, with prompts to start from, is in Set up search.

Agents load small batches of records directly. For a whole catalog, they create an upload key and run a command from your shell, so your records don't pass through the conversation.

Access and safety

  • The workspaces you choose. A connection manages all your workspaces, including ones you create or join later, or only the ones you pick. In each, it has your role: owners and admins can change everything about search, and members can read settings, search, and see analytics. It can't change members, billing, or workspace settings.
  • Free test searches. Searches an agent runs to check its work aren't counted toward your plan or shown in analytics. A workspace can run 600 an hour.
  • Confirmations. Every tool that changes something is marked as one, so clients such as Claude and ChatGPT ask you before running it; tools that only read are marked read-only. Deleting an index or records, deleting a key, and rotating a public ID also need the name typed back.
  • Records are data. Agents are told not to follow instructions found in records, search results, or analytics.
  • Keys. Keys an agent creates appear on the API keys page with the app's name. Upload keys expire after an hour.
  • Limits. 120 requests a minute per connection, and 100 records or 256 KB a call.

To disconnect an agent, revoke it under Connected apps on a workspace's API keys page. It loses that workspace at once, and keeps any others you allowed.

What Findlane keeps about a connection is in the Privacy Policy. For help, see Support.