Skip to content
MCP server

Alexandria

Search, read, and cite across 152 libraries: 11 tools, 3 prompts, and a full-text…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
11.0.0
Listing updated
today

About Alexandria

Alexandria is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Search, read, and cite across 152 libraries: 11 tools, 3 prompts, and a full-text resource.

Install

Run in a terminal

claude mcp add alexandria-mcp --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env ALEXANDRIA_API_KEY='<ALEXANDRIA_API_KEY>' --env CORE_API_KEY='<CORE_API_KEY>' --env COURTLISTENER_API_KEY='<COURTLISTENER_API_KEY>' --env GOVINFO_API_KEY='<GOVINFO_API_KEY>' --env GOOGLE_BOOKS_API_KEY='<GOOGLE_BOOKS_API_KEY>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env NASA_ADS_API_KEY='<NASA_ADS_API_KEY>' --env EUROPEANA_API_KEY='<EUROPEANA_API_KEY>' --env SEMANTIC_SCHOLAR_API_KEY='<SEMANTIC_SCHOLAR_API_KEY>' -- npx -y @the-40-thieves/alexandria-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "alexandria-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@the-40-thieves/alexandria-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "ALEXANDRIA_API_KEY": "<ALEXANDRIA_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "COURTLISTENER_API_KEY": "<COURTLISTENER_API_KEY>",
        "GOVINFO_API_KEY": "<GOVINFO_API_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "NASA_ADS_API_KEY": "<NASA_ADS_API_KEY>",
        "EUROPEANA_API_KEY": "<EUROPEANA_API_KEY>",
        "SEMANTIC_SCHOLAR_API_KEY": "<SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "alexandria-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@the-40-thieves/alexandria-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "ALEXANDRIA_API_KEY": "<ALEXANDRIA_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "COURTLISTENER_API_KEY": "<COURTLISTENER_API_KEY>",
        "GOVINFO_API_KEY": "<GOVINFO_API_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "NASA_ADS_API_KEY": "<NASA_ADS_API_KEY>",
        "EUROPEANA_API_KEY": "<EUROPEANA_API_KEY>",
        "SEMANTIC_SCHOLAR_API_KEY": "<SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "alexandria-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@the-40-thieves/alexandria-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "ALEXANDRIA_API_KEY": "<ALEXANDRIA_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "COURTLISTENER_API_KEY": "<COURTLISTENER_API_KEY>",
        "GOVINFO_API_KEY": "<GOVINFO_API_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "NASA_ADS_API_KEY": "<NASA_ADS_API_KEY>",
        "EUROPEANA_API_KEY": "<EUROPEANA_API_KEY>",
        "SEMANTIC_SCHOLAR_API_KEY": "<SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "alexandria-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@the-40-thieves/alexandria-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "ALEXANDRIA_API_KEY": "<ALEXANDRIA_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "COURTLISTENER_API_KEY": "<COURTLISTENER_API_KEY>",
        "GOVINFO_API_KEY": "<GOVINFO_API_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "NASA_ADS_API_KEY": "<NASA_ADS_API_KEY>",
        "EUROPEANA_API_KEY": "<EUROPEANA_API_KEY>",
        "SEMANTIC_SCHOLAR_API_KEY": "<SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "alexandria-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@the-40-thieves/alexandria-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "ALEXANDRIA_API_KEY": "<ALEXANDRIA_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "COURTLISTENER_API_KEY": "<COURTLISTENER_API_KEY>",
        "GOVINFO_API_KEY": "<GOVINFO_API_KEY>",
        "GOOGLE_BOOKS_API_KEY": "<GOOGLE_BOOKS_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "NASA_ADS_API_KEY": "<NASA_ADS_API_KEY>",
        "EUROPEANA_API_KEY": "<EUROPEANA_API_KEY>",
        "SEMANTIC_SCHOLAR_API_KEY": "<SEMANTIC_SCHOLAR_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENAI_API_KEYOpenAI key for routing (library_ask), synthesis (library_answer, library_research), and embeddings (library_ingest). Search and read tools work without it.
  • ALEXANDRIA_BASE_URLOpenAI-compatible gateway base URL shared by every LLM role (router, synth, research, embeddings, rerank). Falls back to https://api.openai.com/v1.
  • ALEXANDRIA_API_KEYAPI key paired with ALEXANDRIA_BASE_URL. Falls back to OPENAI_API_KEY.
  • CORE_API_KEYUnlocks the core source (CORE, 57M+ open access papers). Free key from core.ac.uk/services/api.
  • COURTLISTENER_API_KEYUnlocks the courtlistener source (US federal and state court opinions). Free key from courtlistener.com.
  • GOVINFO_API_KEYUnlocks govinfo (Congressional Record, Federal Register, US Code); also accepted by congress and regulations. Free key from api.data.gov.
  • GOOGLE_BOOKS_API_KEYUnlocks the googlebooks source (40M+ books). Free key from the Google Cloud Console (Books API).
  • GITHUB_TOKENUnlocks githubsearch and githubmcp (GitHub code search); optional for ghsa and openiti. Public-repo read scope is enough.
  • NASA_ADS_API_KEYUnlocks the nasaads source (NASA Astrophysics Data System). Free key from ui.adsabs.harvard.edu.
  • EUROPEANA_API_KEYUnlocks the europeana source (50M+ European cultural heritage items). Free key from apis.europeana.eu.
  • SEMANTIC_SCHOLAR_API_KEYOptional for semanticscholar and library_recommend; raises the rate limit. Free key from semanticscholar.org/product/api.

Pricing

Open source

Alexandria FAQ

Is Alexandria free?

Yes. Alexandria is open source, so you can use and self-host it for free.

How do I add Alexandria to Claude Code?

Run this command in your terminal: claude mcp add alexandria-mcp --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env ALEXANDRIA_API_KEY='<ALEXANDRIA_API_KEY>' --env CORE_API_KEY='<CORE_API_KEY>' --env COURTLISTENER_API_KEY='<COURTLISTENER_API_KEY>' --env GOVINFO_API_KEY='<GOVINFO_API_KEY>' --env GOOGLE_BOOKS_API_KEY='<GOOGLE_BOOKS_API_KEY>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env NASA_ADS_API_KEY='<NASA_ADS_API_KEY>' --env EUROPEANA_API_KEY='<EUROPEANA_API_KEY>' --env SEMANTIC_SCHOLAR_API_KEY='<SEMANTIC_SCHOLAR_API_KEY>' -- npx -y @the-40-thieves/alexandria-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers