# searchcraft-inc/searchcraft-mcp-server [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/searchcraft-inc/searchcraft-mcp-server  
**GitHub Stars:** 9  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/searchcraft-inc-searchcraft-mcp-server

## Description
Official MCP server for managing Searchcraft clusters, creating a search index, generating an index dynamically given a data file and for easily importing data into a search index given a feed or local json file.

## Tools
Capabilities this server exposes over MCP:

- **create_index** — Create a new index with the specified schema. This will empty the index if it already exists.
- **delete_index** — Delete an index and all its documents permanently.
- **get_all_index_stats** — Get document counts and statistics for all indexes.
- **get_index_schema** — Get the schema definition for a specific index.
- **get_index_stats** — Get statistics and metadata for a specific index (document count, etc.).
- **list_all_indexes** — Get a list of all indexes in the Searchcraft instance.
- **patch_index** — Make partial configuration changes to an index schema (search_fields, weight_multipliers, etc.).
- **update_index** — Replace the entire contents of an existing index with a new schema definition.
- **add_documents** — Add one or multiple documents to an index. Documents should be provided as an array of JSON objects.
- **delete_all_documents** — Delete all documents from an index. The index will continue to exist after all documents are deleted.
- **delete_document_by_id** — Delete a single document from an index by its internal Searchcraft ID (_id).
- **delete_documents_by_field** — Delete one or several documents from an index by field term match (e.g., {id: 'xyz'} or {title: 'foo'}).
- **delete_documents_by_query** — Delete one or several documents from an index by query match.
- **get_document_by_id** — Get a single document from an index by its internal Searchcraft ID (_id).
- **create_federation** — Create or update a federation with the specified configuration.
- **delete_federation** — Delete a federation permanently.
- **get_federation_details** — Get detailed information for a specific federation.
- **get_federation_stats** — Get document counts per index for a federation as well as the total document count.
- **get_organization_federations** — Get a list of all federations for a specific organization.
- **list_all_federations** — Get a list of all federations in the Searchcraft instance.
- **update_federation** — Replace the current federation entity with an updated one.
- **create_key** — Create a new authentication key with specified permissions and access controls.
- **delete_all_keys** — Delete all authentication keys on the Searchcraft cluster. Use with extreme caution!
- **delete_key** — Delete a specific authentication key permanently.
- **get_application_keys** — Get a list of all authentication keys associated with a specific application.
- **get_federation_keys** — Get a list of all authentication keys associated with a specific federation.
- **get_key_details** — Get detailed information for a specific authentication key.
- **get_organization_keys** — Get a list of all authentication keys associated with a specific organization.
- **list_all_keys** — Get a list of all authentication keys on the Searchcraft cluster.
- **update_key** — Update an existing authentication key with new configuration.
- **add_stopwords** — Add custom stopwords to an index. These are added on top of the default language-specific dictionary.
- **delete_all_stopwords** — Delete all custom stopwords from an index. This only affects custom stopwords, not the default language dictionary.
- **delete_stopwords** — Delete specific custom stopwords from an index. This only affects custom stopwords, not the default language dictionary.
- **get_index_stopwords** — Get all stopwords for an index, including both default language dictionary and custom stopwords.
- **add_synonyms** — Add synonyms to an index. Synonyms only work with fuzzy queries, not exact match queries.
- **delete_all_synonyms** — Delete all synonyms from an index.
- **delete_synonyms** — Delete specific synonyms from an index by their keys.
- **get_index_synonyms** — Get all synonyms defined for an index.
- **get_measure_conversion** — Get measurement conversion data with optional filtering and aggregation parameters. *requires Clickhouse if running locally
- **get_measure_summary** — Get measurement summary data with optional filtering and aggregation parameters. *requires Clickhouse if running locally
- **get_search_results** — Performs a search query using the Searchcraft API with support for fuzzy/exact matching, facets, and date ranges.
- **get_prelim_search_data** — Get schema fields and facet information for a search index to understand available fields for constructing queries.
- **get_searchcraft_status** — Get the current status of the Searchcraft search service.
- **analyze_json_from_file** — Read JSON data from a local file and analyze its structure to understand field types and patterns for Searchcraft index schema generation.
- **analyze_json_from_url** — Fetch JSON data from a URL and analyze its structure to understand field types and patterns for Searchcraft index schema generation.
- **generate_searchcraft_schema** — Generate a complete Searchcraft index schema from analyzed JSON structure, with customizable options for search fields, weights, and other index settings.
- **create_index_from_json** — Complete workflow to create a Searchcraft index from JSON data. Fetches JSON from URL or file, analyzes structure, generates schema, creates the index, and adds all documents in one step.
- **create_vite_app** — Creates a complete Vite + React search application from JSON data. Analyzes your data structure, generates optimized search templates, and creates a fully functional web app with Searchcraft integration.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "searchcraft-mcp-server": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"]
  }
}
```

## Documentation

## What searchcraft-inc/searchcraft-mcp-server does

The searchcraft-inc/searchcraft-mcp-server MCP server connects MCP clients to Searchcraft, a vertical search engine. Its tools cover the main objects managed in a Searchcraft cluster: indexes, documents, federations, authentication keys, stopwords, synonyms, and search analytics.

Index tools can create, replace, patch, inspect, list, and delete indexes. Document tools add JSON objects, retrieve a document by its internal `_id`, and remove documents by ID, field match, query, or by clearing an entire index. Destructive operations include deleting an index and deleting all keys, so clients should treat those operations as administrative actions.

## How it works

The searchcraft-inc/searchcraft-mcp-server MCP server is intended for natural-language use through an MCP client. A client can invoke direct Searchcraft operations, such as creating an index with a schema, checking document counts, configuring a federation, or creating an access key with permissions and access controls.

Import workflows support JSON sources from either a local file or a URL. The client can first inspect the data structure, generate a Searchcraft schema with search fields and weighting options, then create the index and add the documents. The `create_index_from_json` workflow combines those stages into one operation.

Search tools support fuzzy or exact matching, facets, and date ranges. Search configuration can also include custom stopwords and synonyms; the documentation notes that synonyms apply to fuzzy queries rather than exact-match queries. Analytics tools provide measurement summaries and conversion data with optional filtering and aggregation.

## Tools and capabilities

The available capabilities include:

- Create, update, patch, inspect, list, and delete Searchcraft indexes.
- Add documents and retrieve or remove them using IDs, field terms, queries, or bulk deletion.
- Create, inspect, update, list, and delete federations, including federation statistics.
- Create, inspect, update, list, and delete authentication keys at cluster, organization, application, or federation scope.
- Analyze JSON files or URLs and generate schemas for imported data.
- Configure index stopwords and synonyms.
- Run searches, inspect preliminary schema and facet data, check service status, and query measurement analytics.

## Limitations and notes

The searchcraft-inc/searchcraft-mcp-server MCP server manages Searchcraft resources; the supplied material does not document a standalone local search engine or an offline mode. Measurement conversion and summary tools require ClickHouse when the server is run locally. The README identifies TypeScript, Node.js 22+, and Express among the project technologies, but the provided excerpt does not specify a package installation command, environment-variable names, license, or credential configuration procedure.

Operations that delete indexes, documents, federations, or keys can permanently remove data or access credentials. Use the inspection and statistics tools before making destructive changes, particularly `delete_all_keys`, which removes every authentication key on the cluster.

## Getting started with this searchcraft-inc/searchcraft-mcp-server MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/searchcraft-inc-searchcraft-mcp-server/readme_