Docs

MCP Server

Use Airweave as a Model Context Protocol server for AI agents

Airweave’s MCP (Model Context Protocol) server lets AI assistants search through your connected data sources using natural language queries. Perfect for Claude Desktop, Cursor, and any MCP-compatible tool.

What is MCP?

Model Context Protocol is an open standard that enables AI assistants to interact with external tools and data sources. Airweave’s MCP server transforms your collections into searchable knowledge bases that agents can query directly.

Features

Semantic Search

Query all your connected data sources with simple questions

AI Completions

Get intelligent responses based on your data

Secure & Simple

API key authentication with zero setup required

Quick Start

1

Get Your Credentials

You’ll need two things from your Airweave dashboard:

  • API Key (Settings > API Keys)
  • Collection ID (e.g., my-collection-abc123)
2

Configure Your AI Tool

Choose your tool below and add the configuration. No separate server setup needed - your AI tool will automatically run the MCP server when needed.

Requirements

Cursor version 0.45.6 or later

  1. Open Cursor Settings
  2. Go to Features > MCP Servers
  3. Click ”+ Add new global MCP server”
  4. Add this configuration:
Cursor Configuration
1{
2  "mcpServers": {
3    "airweave-search": {
4      "command": "npx",
5      "args": ["-y", "airweave-mcp-search"],
6      "env": {
7        "AIRWEAVE_API_KEY": "your-api-key",
8        "AIRWEAVE_COLLECTION": "your-collection-id"
9      }
10    }
11  }
12}

Access via Command+L (Mac) or Ctrl+L (Windows). The Composer Agent will automatically use Airweave for search queries.

3

Start Searching

Ask your AI assistant natural language questions about your data:

  • “What are our latest product features?”
  • “Find customer feedback about pricing”
  • “Show me API documentation”

That’s it! Your AI agent can now search across all your connected data sources in the collection.

Available Tools

The MCP server provides two powerful search tools:

Natural language search across your entire collection with optional AI-powered responses.

ParameterTypeDescription
querystring (required)Your search question
response_typestring (optional)"RAW" for search results or "COMPLETION" for AI analysis

get-config

View current configuration and connection status to verify everything is working correctly.

No parameters required - shows your collection ID, API endpoint, and connection status.

Environment Variables

Required

AIRWEAVE_API_KEY Your Airweave API key

AIRWEAVE_COLLECTION Collection ID to search

Optional

AIRWEAVE_BASE_URL Custom API endpoint

Default: https://api.airweave.ai

Troubleshooting

  • Check your API key is correctly set in the configuration
  • Generate a new API key from your Airweave dashboard
  • Ensure the API key has access to your collection
  • Verify the collection ID is correct (use the readable ID like my-collection-abc123)
  • Check that the collection exists in your Airweave account
  • Ensure you have access permissions for the collection
  • Check your internet connection
  • For self-hosted instances, verify the server is running and AIRWEAVE_BASE_URL is correct
  • Ensure firewall rules allow the connection

Next Steps

Browse Connectors

Explore our 28+ pre-built data source connectors

API Reference

Dive deeper into the full Airweave API

Get Support

Join our community for help and discussions