Published NFT Literature Server

Open-source Model Context Protocol-style knowledge-base server for Published NFT — the Flow-blockchain marketplace for books and literary NFTs. It gives AI assistants (Claude, Cursor, and any MCP/REST client) real-time access to the Published NFT documentation, NFT collections, Flow blockchain education, pricing, bookmarks, decorations, and the Published Daily newspaper.

This is the runnable, framework-agnostic extraction of the server hosted at https://publishednft.io/api/mcp (which powers the "Cindy" voice agent).

Tools

Tool	What it does
searchDocumentation	Full-text search across the bundled docs (relevance-ranked).
getCollectionInfo	Details for an NFT collection (Genesis Pass, BOAST6, classics, …).
getFlowBlockchainInfo	Flow blockchain concepts — Cadence, FCL, wallets, testnet/mainnet.
getPricingInfo	Current prices and payment methods (DUC / FLOW / USD).
getBookmarksInfo	Literary bookmark NFTs and their traits.
getDecorationsInfo	Avatar decorations (frames, stamps, spines, bookplates).
getAppFeaturesInfo	Platform features (VR/AR reading, EPUB reader, AI assistant, …).
getNewspaperInfo	The Published Daily on-chain newspaper.

Transport (REST)

GET  /   → health check + tool list
POST /   → { "tool": "<name>", "args": { ... } }  → { success, tool, result }

Both { "tool", "args" } and { "name", "arguments" } request shapes are accepted.

Run it

Requires Node ≥ 18.

git clone https://github.com/publishednft/mcp-literature-server.git
cd mcp-literature-server
npm install
npm start            # tsx src/server.ts  → http://localhost:8000
# or build + serve
npm run build && npm run serve

# Health
curl http://localhost:8000

# Search
curl -X POST http://localhost:8000 \
  -H 'Content-Type: application/json' \
  -d '{ "tool": "searchDocumentation", "args": { "query": "genesis pass" } }'

# Pricing
curl -X POST http://localhost:8000 \
  -d '{ "tool": "getPricingInfo", "args": {} }'

PORT env var overrides the default 8000.

Use the hosted server (no install)

Point any MCP/SSE-capable client at the live endpoint:

https://publishednft.io/api/mcp?userId=YOUR_WALLET_ADDRESS

See the connect guide at https://publishednft.io/mcp.

Project layout

src/
  server.ts          # plain Node HTTP server (GET health / POST dispatch)
  tools/             # the 8 tool handlers + zod schemas
  utils/             # markdown loader, search index, helpers
docs/                # the literature knowledge base (markdown)

The only runtime dependency is zod (schema validation); everything else is Node builtins.

License

MIT © Published NFT