Searchcraft MCP Server

Searchcraft's MCP Server

Local serverstdioPython

What is the Searchcraft MCP Server?

Searchcraft's MCP Server

The short version

An MCP Server powered by Searchcraft – the developer-first vertical search engine.

What it needs from you

  • Existing Searchcraft Index → The index specified in VITE_INDEX_NAME should already exist - Valid Read Key → The VITE_READ_KEY must have read permissions for the index - Git Available → The tool uses git to clone the template repository - Node.js & Yarn → Required for dependency installation

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
OneStep → Use create_index_from_json to analyze, generate schema, create the index, and import all documents in one command
create_indexCreate a new index with the specified schema. This will empty the index if it already exists.
delete_indexDelete an index and all its documents permanently.
get_all_index_statsGet document counts and statistics for all indexes.
get_index_schemaGet the schema definition for a specific index.
get_index_statsGet statistics and metadata for a specific index (document count, etc.).
list_all_indexesGet a list of all indexes in the Searchcraft instance.
patch_indexMake partial configuration changes to an index schema (search_fields, weight_multipliers, etc.).
update_indexReplace the entire contents of an existing index with a new schema definition.
add_documentsAdd one or multiple documents to an index. Documents should be provided as an array of JSON objects.
delete_all_documentsDelete all documents from an index. The index will continue to exist after all documents are deleted.
delete_document_by_idDelete a single document from an index by its internal Searchcraft ID (_id).
delete_documents_by_fieldDelete one or several documents from an index by field term match (e.g., {id: 'xyz'} or {title: 'foo'}).
delete_documents_by_queryDelete one or several documents from an index by query match.
get_document_by_idGet a single document from an index by its internal Searchcraft ID (_id).
create_federationCreate or update a federation with the specified configuration.
delete_federationDelete a federation permanently.
get_federation_detailsGet detailed information for a specific federation.
get_federation_statsGet document counts per index for a federation as well as the total document count.
get_organization_federationsGet a list of all federations for a specific organization.
list_all_federationsGet a list of all federations in the Searchcraft instance.
update_federationReplace the current federation entity with an updated one.
create_keyCreate a new authentication key with specified permissions and access controls.
delete_all_keysDelete all authentication keys on the Searchcraft cluster. Use with extreme caution!
delete_keyDelete a specific authentication key permanently.
get_application_keysGet a list of all authentication keys associated with a specific application.
get_federation_keysGet a list of all authentication keys associated with a specific federation.
get_key_detailsGet detailed information for a specific authentication key.
get_organization_keysGet a list of all authentication keys associated with a specific organization.
list_all_keysGet a list of all authentication keys on the Searchcraft cluster.
update_keyUpdate an existing authentication key with new configuration.
add_stopwordsAdd custom stopwords to an index. These are added on top of the default language-specific dictionary.
delete_all_stopwordsDelete all custom stopwords from an index. This only affects custom stopwords, not the default language dictionary.
delete_stopwordsDelete specific custom stopwords from an index. This only affects custom stopwords, not the default language dictionary.
get_index_stopwordsGet all stopwords for an index, including both default language dictionary and custom stopwords.
add_synonymsAdd synonyms to an index. Synonyms only work with fuzzy queries, not exact match queries.
delete_all_synonymsDelete all synonyms from an index.
delete_synonymsDelete specific synonyms from an index by their keys.
get_index_synonymsGet all synonyms defined for an index.
get_measure_conversionGet measurement conversion data with optional filtering and aggregation parameters. requires Clickhouse if running locally
get_measure_summaryGet measurement summary data with optional filtering and aggregation parameters. requires Clickhouse if running locally
get_search_resultsPerforms a search query using the Searchcraft API with support for fuzzy/exact matching, facets, and date ranges.
get_prelim_search_dataGet schema fields and facet information for a search index to understand available fields for constructing queries.
get_searchcraft_statusGet the current status of the Searchcraft search service.
analyze_json_from_fileRead JSON data from a local file and analyze its structure to understand field types and patterns for Searchcraft index schema generation.
analyze_json_from_urlFetch JSON data from a URL and analyze its structure to understand field types and patterns for Searchcraft index schema generation.
generate_searchcraft_schemaGenerate a complete Searchcraft index schema from analyzed JSON structure, with customizable options for search fields, weights, and other index settings.
create_index_from_jsonComplete workflow to create a Searchcraft index from JSON data. Fetches JSON from URL or file, analyzes structure, generates schema, creates the index, and adds
create_vite_appCreates a complete Vite + React search application from JSON data. Analyzes your data structure, generates optimized search templates, and creates a fully funct

How to install the Searchcraft MCP Server

{
  "mcpServers": {
    "searchcraft": {
      "command": "node",
      "args": [
        "/path/to/searchcraft-mcp-server/dist/stdio-server.js"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Existing Searchcraft Index → The index specified in VITE_INDEX_NAME should already exist - Valid Read Key → The VITE_READ_KEY must have read permissions for the index - Git Available → The tool uses git to clone the template repository - Node.js & Yarn → Required for dependency installation

Example prompts to try

  • “Use Searchcraft to One.”
  • “Use Searchcraft to analyze json from file.”
  • “Use Searchcraft to analyze json from url.”

Frequently asked questions

Searchcraft's MCP Server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.