Searchcraft

The Searchcraft MCP Server provides a suite of tools for managing your Searchcraft cluster's Documents, Indexes, Federations, Access Keys, and Analytics. It enables MCP Clients, like Claude Desktop, to be prompted in plain English to perform administrative actions like setting up search indexes, access keys, ingesting documents, viewing analytics, searching indexes, and more.

Building an app in 2 minutes with Searchcraft MCP Server (video link)

Sample Prompts

Here is a sample prompt that could be used once Claude is connected to the Searchcraft MCP Server.

I'd like to create a product search application using the create_vite_app tool.

Please use this JSON dataset https://dummyjson.com/products
First use the Searchcraft create_index_from_json tool to create the index and add the documents.

Then create an API read key for the vite app using the create_key tool.

App details:
- App name: "my-ecommerce-app"
- Endpoint: http://localhost:8000
- Index name: my-ecommerce-app

Available Tools

The Searchcraft MCP Server currently provides three categories of tools, import tools, engine api tools, and app generation tools:

Engine API Tools

These tools provide direct access to your Searchcraft cluster's core functionality for managing indexes, documents, federations, authentication, and search operations.

Index Management

Document Management

Federation Management

Authentication & Key Management

Stopwords Management

Synonyms Management

Search & Analytics

Import Tools

These tools provide workflows for importing JSON data and automatically generating Searchcraft schemas. Perfect for quickly setting up new indexes from existing data sources.

Import Tools Workflow

The import tools are designed to work together in a streamlined workflow:

1. Analyze → Use analyze_json_from_file or analyze_json_from_url to examine your JSON data structure
2. Generate → Use generate_searchcraft_schema to create a customized Searchcraft schema from the analysis
3. Create → Use the Engine API create_index tool to create the index with your generated schema
4. Import → Use add_documents to populate your new index with data

Or use the all-in-one approach:

• One-Step → Use create_index_from_json to analyze, generate schema, create the index, and import all documents in one command

App Generation Tools

These tools create complete, ready-to-run search applications from your JSON data, perfect for prototyping and demos.

App Generation Workflow

The app generation tools provide an end-to-end solution for creating search applications:

1. Data Analysis → Automatically analyzes your JSON structure to understand field types and content
2. Template Generation → Creates optimized search result templates based on your data fields
3. App Creation → Clones and configures a complete Vite + React application
4. Environment Setup → Configures Searchcraft connection settings
5. Ready to Run → Provides a fully functional search app you can immediately start and customize

Detailed Tool Usage

Using create_index_from_json

The create_index_from_json tool provides a complete workflow to create a Searchcraft index from JSON data in a single command. This is perfect for quickly setting up search indexes from existing datasets. Note, if you know the language of the data you are importing you should specify it with the language parameter (use the ISO 639-1 two letter code for the language)

Parameters

Example Usage

From a URL:

{
  "source": "url",
  "path": "https://api.example.com/products.json",
  "index_name": "products",
  "sample_size": 50,
  "search_fields": ["title", "description", "category"],
  "weight_multipliers": {
    "title": 2.0,
    "description": 1.0,
    "category": 1.5
  }
}

From a local file:

{
  "source": "file",
  "path": "/path/to/data.json",
  "index_name": "my_data",
  "language": "en"
}

What it does

1. Fetches/Reads Data → Downloads from URL or reads from local file
2. Analyzes Structure → Examines JSON to understand field types and patterns

…