Skip to main content
The Aigmented MCP server lets you search and ask questions from your knowledge base directly inside Claude Desktop, Cursor, or any MCP-compatible client.
The MCP package @aigmented/mcp is not yet published to npm. For now, use the source build from the repository.

Setup for Claude Desktop

Add to your claude_desktop_config.json:
{
  "mcpServers": {
    "aigmented": {
      "command": "npx",
      "args": ["@aigmented/mcp"],
      "env": {
        "AIGMENTED_API_KEY": "sk-YOUR_API_KEY",
        "AIGMENTED_COLLECTION_ID": "49"
      }
    }
  }
}

Setup for Cursor

Add to Cursor’s MCP settings:
{
  "aigmented": {
    "command": "npx",
    "args": ["@aigmented/mcp"],
    "env": {
      "AIGMENTED_API_KEY": "sk-YOUR_API_KEY",
      "AIGMENTED_COLLECTION_ID": "49"
    }
  }
}

Environment variables

VariableRequiredDefaultDescription
AIGMENTED_API_KEYYesYour API key (sk-...)
AIGMENTED_API_URLNohttps://aigmented.ioAPI base URL
AIGMENTED_COLLECTION_IDNoDefault collection ID (if omitted, must specify per-tool call)

Available tools

search_knowledge

Search your knowledge base for relevant cards.
ParameterRequiredDescription
queryYesSearch query
collection_idNoCollection ID (uses default if omitted)
top_kNoMax results (default 5)

ask_question

Ask a question and get an AI-generated answer with sources.
ParameterRequiredDescription
questionYesYour question
collection_idNoCollection ID (uses default if omitted)

list_collections

List all available knowledge collections. No parameters.

get_card_details

Get full details of a specific knowledge card.
ParameterRequiredDescription
card_idYesCard ID (from search results)

HTTP mode (LibreChat)

For LibreChat or other HTTP-based MCP clients, run the HTTP server:
AIGMENTED_API_KEY=sk-YOUR_KEY npx @aigmented/mcp --http
This starts an HTTP server on port 3002 (configurable via MCP_PORT) with the MCP Streamable HTTP transport at /mcp.