# ForgeMesh Library MCP

> ForgeMesh Library MCP is a paid MCP server for knowledge and memory. Pay-per-call public-domain book search and passages for agents, paid in USDC on Base. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://library.forgemesh.io
- **Repository:** https://github.com/forgemeshlabs/library-mcp
- **MCP Registry name:** io.github.forgemeshlabs/library-mcp
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

Every answer comes from indexed book text, never from a language model: the service returns cited passages with book, author and location, which suits tutoring and quiz tools where an invented quote is worse than none. The corpus is described as more than 61,000 public-domain books, drawn in part from Project Gutenberg, with ten curated wings and 276 subject shelves.

There is no account or API key. Each call is paid through the x402 protocol in USDC on Base, from $0.005 for metadata and shelves to $0.02 for full-text search. Requests that miss, fail or time out are rejected before settlement, so they are not charged.

The npm package needs a dedicated low-balance wallet key. It refuses any payee other than the Library wallet, any network other than Base mainnet, any asset other than USDC and any amount over $0.02 per call or $10 per session.

## Features

- **Cited passage retrieval:** Returns real excerpts with book, author and location, with no generated summaries.
- **Ask a flagship book:** Named routes for classics such as Moby-Dick, Dracula and The Republic.
- **Subject shelves:** Ten curated wings plus 276 shelves built from subject metadata.
- **No charge on misses:** Failed lookups and timeouts are rejected before payment settles.
- **Signed receipts:** Offers and settlements are attested with EIP-712 signatures.
- **Built-in spend caps:** Session and per-call limits that can only be lowered by the user.

## Good for

- Let a tutoring agent quote a real passage from a classic
- Generate quizzes grounded in public-domain text
- Build a reading app that searches across 61,000 books
- Pull a chapter or notable quotes for a book club bot

## Install

### Claude Code (Terminal)

```sh
claude mcp add library-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/library-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "library-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/library-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "library-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/library-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "library-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/library-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "library-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/library-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "library-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/library-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `search_literature`: Full-text search across the whole corpus, returning real passages.
- `search_books`: Search books by title or author substring.
- `get_book_metadata`: Title, author, year, subjects, bookshelves and chapter range for a book id.
- `get_chapter`: Full text of one chapter by book id and chapter number.
- `get_quotes`: Notable passages from a book, optionally themed.
- `ask_book`: Ask a flagship book a question and get cited passages back.
- `browse_shelf`: Browse a curated category or subject shelf.
- `book_of_the_day`: Deterministic daily book pick.
- `library_card`: Mint a soulbound Reader's Card NFT on Base to the paying wallet.

## FAQ

### How are calls paid for?

In USDC on Base through the x402 protocol; the price is in each call's 402 challenge.

### Is any answer generated by an LLM?

No. The README says every answer is a retrieved passage, never summarized or generated.

### What does a call cost?

The README lists $0.005 to $0.02 per call; the live challenge is authoritative.

### Is a free tier available?

The package states all tools need a wallet; the website mentions free discovery without one.

### Is ForgeMesh Library MCP free?

No. ForgeMesh Library MCP is a paid product.

### How do I add ForgeMesh Library MCP to Claude Code?

Run this command in your terminal: claude mcp add library-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/library-mcp

### What are the best alternatives to ForgeMesh Library MCP?

The closest alternatives to ForgeMesh Library MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/forgemesh-library-mcp
