# WarpSearch

> WarpSearch is a freemium MCP server for databases. Serverless search over JSON documents queryable in SQL, Elasticsearch DSL or Solr. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** API, Web
- **Website:** https://warpsearch.io/docs/agents
- **MCP Registry name:** io.github.warpsearchio/warpsearch
- **Categories:** databases, analytics and data
- **Listing updated:** 2026-11-16

## About

WarpSearch handles full-text (BM25), vector and faceted search plus analytics on JSON documents, and lets the caller use whichever query language it knows: SQL, Elasticsearch or OpenSearch Query DSL, Solr, Lucene, Grafana, LogQL or its native expressions. translate_query shows how a query is executed, and compatibility endpoints let existing Elasticsearch, OpenSearch and Solr clients connect.

An unusual feature is agent sign-up. Connected without a key, the server offers only register and claim_registration: the agent registers with the user's work email, shows a user code, and the user approves by email; the API key is delivered once. Personal mailbox providers are refused during the public preview.

Tools such as graph_neighbors, graph_paths and graph_expand support graph search, and available tools depend on the key's role (read, write, manage, admin). Billing is usage-based after a free gigabyte.

## Features

- **Many query languages:** SQL, Elasticsearch DSL, Solr, Lucene, LogQL and more.
- **Hybrid search:** Keyword, vector and hybrid on one index.
- **Agent self-registration:** Agents obtain a key with the user's email approval.
- **Graph tools:** Walk neighbors and paths over adjacency fields.
- **Role-based tools:** Only tools a key's role allows are listed.
- **Compatibility APIs:** Elasticsearch, OpenSearch and Solr endpoints.

## Good for

- Give an app a search backend without managing a cluster
- Search logs and events with SQL
- Use as searchable agent memory
- Migrate queries from Elasticsearch

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http warpsearch https://api.warpsearch.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.warpsearch.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "warpsearch": {
      "url": "https://api.warpsearch.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "warpsearch": {
      "type": "http",
      "url": "https://api.warpsearch.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "warpsearch": {
      "serverUrl": "https://api.warpsearch.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "warpsearch": {
      "type": "http",
      "url": "https://api.warpsearch.io/mcp"
    }
  }
}
```

## Tools

- `register`: Starts a sign-up for the user by email.
- `claim_registration`: Collects the API key once approved.
- `list_collections`: Lists usable collections and the role on each.
- `describe_collection`: Returns field names and types.
- `whoami`: Shows tenant, key and roles.
- `search`: Runs a query in any supported language.
- `translate_query`: Shows how a query is run without running it.
- `count`: Counts matching documents.
- `get_document`: Fetches one document by id.
- `graph_neighbors`: Walks from seeds to nearby nodes.
- `graph_paths`: Finds paths between node sets.
- `graph_expand`: Runs a full graph expand request.
- `index_documents`: Adds or replaces documents.
- `delete_documents`: Deletes documents by id.
- `create_collection`: Creates a collection with an optional schema.

## FAQ

### Is there a free tier?

Yes: 1 GB, one collection, 10,000 queries a month, 20 hits per query, no card.

### How is paid usage priced?

$10 a month including $10 of usage; $0.08 per GB stored, $1.00 per GB written and $2.00 per million requests at the first tier.

### Can an agent get its own key?

Yes, via register and claim_registration with the user's work email.

### Which roles exist?

Read, write, manage and admin.

### Is WarpSearch free?

WarpSearch has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add WarpSearch to Claude Code?

Run this command in your terminal: claude mcp add --transport http warpsearch https://api.warpsearch.io/mcp

### What are the best alternatives to WarpSearch?

The closest alternatives to WarpSearch are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, Midplane and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/warpsearch
