TextStack.Mcp 1.1.0

dotnet tool install --global TextStack.Mcp --version 1.1.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local TextStack.Mcp --version 1.1.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=TextStack.Mcp&version=1.1.0
                    
nuke :add-package TextStack.Mcp --version 1.1.0
                    

TextStack.Mcp

The TextStack MCP server — connect your TextStack reading library to Claude Desktop, Cursor, or any Model Context Protocol client. Ask your books questions, read chapters, and manage your highlights and vocabulary straight from your AI assistant.

It exposes 14 tools:

Tool What it does
search_books Search the public book catalog by query
get_book Fetch a book's metadata and chapter list by slug
get_chapter Fetch the full text of a single chapter
ask_book Ask a question about a book and get a cited, grounded answer
search_my_library Search the books you uploaded (requires sign-in)
get_my_book Fetch one of your uploads: metadata + chapter list (requires sign-in)
get_my_chapter Fetch the full text of one chapter of your upload (requires sign-in)
save_my_highlight Highlight a passage in a book you uploaded (requires sign-in)
list_my_book_highlights List the highlights in a book you uploaded (requires sign-in)
save_insight Write a conclusion back into a book, against a chapter or the whole book (requires sign-in)
get_my_insights Read back everything already worked out about a book (requires sign-in)
list_my_highlights List your saved highlights (requires sign-in)
save_highlight Save a passage to your highlights (requires sign-in)
list_my_vocabulary List your saved vocabulary words (requires sign-in)

Install

dotnet tool install -g TextStack.Mcp

This installs the textstack-mcp command (.NET 10+; rolls forward to future majors).

On .NET 10 you can also run it without installing:

dnx textstack-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "textstack": {
      "command": "textstack-mcp",
      "env": {
        "TEXTSTACK_API_URL": "https://textstack.app/api",
        "TEXTSTACK_SITE_HOST": "textstack.app"
      }
    }
  }
}

The server speaks MCP over stdio by default — exactly what a local desktop client needs. The catalog tools (search_books, get_book, get_chapter) work without signing in.

Your own uploads are a separate half of the library, reached by the *_my_* tools and identified by a bookId. A bookId is not an editionId: passing one to ask_book or list_my_highlights returns nothing rather than an error, so keep the two apart.

Auth (for your highlights / vocabulary)

The first user-scoped tool call returns a message like "authentication required — open https://textstack.app/device and enter code XXXX-XXXX". Open the device page, sign in, enter the code, then retry the call.

Remote option (no install)

Prefer not to run anything locally? Point a Streamable-HTTP MCP client at the hosted endpoint instead:

https://textstack.app/mcp

More: https://textstack.app/en/mcp

License

AGPL-3.0-or-later.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.1.0 170 9/8/2026
1.0.1 161 6/17/2026
1.0.0 148 6/17/2026