Skip to content
MCP server

ForgeMesh Library MCP

Pay-per-call public-domain book search and passages for agents, paid in USDC on Base

Runs locallyStatus and history
Pricing
Paid
Platforms
API, CLI
Runs
Locally
Version
0.1.9
Listing updated
3 days ago

About ForgeMesh Library MCP

ForgeMesh Library MCP is a paid MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • WALLET_PRIVATE_KEYDedicated low-balance Base wallet private key for x402 USDC micropayments. Required for all 8 tools (there are no free tools in this package). Never use your primary wallet.Required
  • LIBRARY_BASE_URLLibrary API origin override. Defaults to https://library.forgemesh.io.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid

Pay per call, $0.005 to $0.02 in USDC on Base

Prices change. Check library.forgemesh.io before you buy.

ForgeMesh Library MCP 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 to ForgeMesh Library MCP

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity