Published NFT
Beta
Published Literature Knowledge API

Literary Knowledge API

A REST API exposing 10 tools for everything about Published NFT — collections, pricing, Flow blockchain, app features, bookmarks, decorations, and newspapers — plus a write tool that lets agents and publishers submit ebooks for publication. The same knowledge layer that powers our assistant, Cindy.

Checking server…
REST · JSON · No SDK required

One endpoint, 10 knowledge tools

Every tool is a single HTTP POST. Send the tool name and its arguments, get a structured JSON answer back. Eight tools are read-only — they return facts about the platform, never mutate state. One tool, submitEbook, is a write action: agents and publishers use it to submit an ebook for publication on an author's behalf.

Collection details, pricing & payment methods
Flow blockchain & Cadence explainers
Full-text documentation search

Request / Response

POST https://publishednft.io/api/mcp
{ "tool": "getPricingInfo", "args": {} }
200 OK
{ "success": true, "tool": "getPricingInfo", "result": { ... } }

Available Tools

searchDocumentation
read-only

Full-text search across the entire Published NFT documentation set, ranked by relevance.

args: query: string, category?: "flow" | "nft" | "pricing" | "technical" | "general"

getCollectionInfo
read-only

Price, features, availability, payment methods, and purchase URL for a specific collection.

args: collectionName: string (60+ collections, e.g. genesis-pass-v2)

getPricingInfo
read-only

Current pricing and payment methods across all collections, including the free religious texts.

args: (no arguments)

getFlowBlockchainInfo
read-only

Educational explainers on Flow & Cadence concepts as they apply to Published NFT.

args: topic: basics | cadence | fcl | wallets | testnet | mainnet | transactions | smart-contracts | nft-standards

getAppFeaturesInfo
read-only

How the app's features work — readers, AI tools, VR/AR, marketplace, profiles, and more.

args: topic?: overview | ai-tools | epub-reader | audiobooks | vr-ar | marketplace | profile | wallet | community | creators

getBookmarksInfo
read-only

The bookmark system — collectible bookmark NFTs and saved reading positions.

args: topic?: overview | collectible-bookmarks | reading-bookmarks | how-to-use | staking | rarities

getDecorationsInfo
read-only

Avatar decoration NFTs — frames, stamps, spines, and bookplates.

args: topic?: overview | avatar-frames | stamps | spines | bookplates | shop | equipping | rarities

getNewspaperInfo
read-only

Public-domain newspaper archive (Library of Congress Chronicling America).

args: topic?: overview | how-to-browse | search-tips | by-state | by-era | popular-newspapers | features | public-domain

submitEbook
WRITE

WRITE — submit an ebook for publication on an author's behalf. Records the application, emails the author a DocuSign agreement, schedules a review, and alerts the team. The only state-changing tool.

args: authorName, email, bookTitle, synopsis (required); genre?, manuscriptLink?, telegramHandle?, submitterName?, submitterRole? (author|agent|publisher), apiKey?

getContractInfo
read-only

Reference the platform's legal documents — the Author Licensing Agreement (what authors sign to publish) and the Mutual NDA — with their gated download links. Never returns raw PDF bytes.

args: document?: author-licensing-agreement | mutual-nda

Talk to your Bookworms from Claude or ChatGPT

Make a key in your worm's Dot settings, then connect the Bookworms MCP to Claude, ChatGPT or any MCP client. List your worms, talk to them, run their routines, manage their bookshelf, and switch their website embed on or off - approvals stay with you in the app.

claude mcp add --transport http bookworms \
  https://publishednft.io/api/pfp/dots/mcp \
  --header "Authorization: Bearer pndot_…"
Put a Bookworm on your website

Open your worm's Embed tab, allow your site, and paste one line. Visitors see it in 3D, chat with it and talk to it out loud while its mouth moves. It meets them in public mode - never your memories or accounts - on your keys, within the daily limits you set. A server API is there too.

<script src="https://publishednft.io/embed.js"
  data-worm="pnw_…" async></script>

Frequently Asked Questions