Tools & resources

The server exposes 25 read-only tools (always available) plus opt-in write tools (local stdio by default; HTTP signing requires an explicit unsafe trusted-deployment override — see write operations).

Tools

Tool	Description
get-account	Full account info: profile, wallet balances, Blurt Power, delegations, witness votes, rewards.
get-account-history	Account operation history, optionally filtered by operation type (vote, transfer, comment, …).
get-account-posts	Posts related to an account (blog, feed, posts, comments, replies, payout) via the Nexus L2 API.
get-post	A single post, or the full discussion tree (with_comments=true).
get-publications	Ranked posts (trending, hot, created, promoted, payout, …) via Nexus getRankedPosts.
get-blurt-price	Current BLURT price in USD and BTC from the public price feed.
get-chain-status	Network + market overview: head block, supply, reward fund, participation, price, market cap.
list-communities	Directory of Blurt blockchain communities (rank / new / subscribers), with search and pagination.
get-community	Details of a single community (subscribers, moderators, pending payout, …).
get-post-votes	Votes on a post/comment ranked by weight (rshares), for curation analysis.
get-vote-value	Estimated value of an account's upvote, in BLURT and USD, at a given weight.
list-witnesses	Top witnesses (block producers) ranked by vote weight, with missed blocks and version.
get-witness	Single witness details + a health read (vote weight, blocks behind head, enabled).
get-account-witness-votes	Which witnesses an account supports (and its proxy, if any).
get-account-relationships	Follower/following counts and a sample of each (social graph).
get-pending-rewards	Unclaimed author/curation rewards (claimable now), in BLURT and USD.
get-account-subscriptions	Communities an account is subscribed to, with its role in each.
compare-accounts	Side-by-side metrics for 2–5 accounts (BP, reach, output, earnings) in one call.
get-referrals	Accounts a referrer brought to the Blurt blockchain (beBlurt referral system), with the total count.
get-account-notifications	An account's recent notifications (mentions, replies, votes, follows, reblogs) + unread count.
get-post-reblogs	The accounts that reblogged a post, and how many (reach signal beyond votes).
get-delegations	Outgoing Blurt Power delegations of an account (per delegatee), converted to BLURT.
lookup-accounts	Autocomplete Blurt blockchain account names by prefix (alphabetical).
search	Resolve a free-form query into Blurt blockchain resource links (account, history, posts, single post).
fetch	Retrieve the raw JSON of a Blurt blockchain resource from a blurt://… URI or shorthand id.

search and fetch follow the connector convention used by ChatGPT-style clients.

Each tool ships with a verbose, LLM-oriented description (visible in the client) explaining when to use it, its parameters and its output — for an AI client, the description is the interface.

The v1-candidate contract index is generated from source-of-truth registry metadata in tools.generated.md. Regenerate it with npm run docs:tools and verify it with npm run docs:check.

Write tools (opt-in, local stdio by default)

Write tools are documented in one canonical place: write operations.

That page explains which tools exist, which capability profiles expose them, what each tool broadcasts, and how dry_run, optional BLURT_WRITE_RATE_LIMITS and the unsafe HTTP override work. Keeping the detailed list in one place avoids drift between the readable overview and the security-sensitive signing guide.

Resources

Resource templates resolvable via the fetch tool or a resource-aware client:

• blurt://account/{username}
• blurt://history/{username}?limit=&ops=vote,comment
• blurt://posts/{by}/{tag}?limit= — by ∈ trending|hot|created|promoted|payout|payout_comments|muted
• blurt://account-posts/{sort}/{account}?limit= — sort ∈ blog|feed|posts|comments|replies|payout
• blurt://post/{author}/{permlink}?with_comments=true

Example prompts

You never tell the AI which tool to use — it picks and chains them. Start simple, then push.

Market & network

• "What is the current BLURT price in USD?"
• "What is the Blurt blockchain's market cap and how many BLURT are in circulation?"
• "Is the Blurt blockchain healthy right now?"

Accounts & wallets

• "Show me the account nalexadre and convert its BLURT balance to USD."
• "How much Blurt Power does nalexadre have?"

Curation

• "How much is a 100% upvote from nalexadre worth, in BLURT and USD?"
• "Who are the top 5 curators on the post nalexadre/how-ai-can-help-curation-on-blurt-1759501073717?"

Communities

• "What are the most popular Blurt blockchain communities?"
• "Find a community about photography and show me its details."

Governance

• "List the top 10 Blurt blockchain witnesses and flag any that look inactive or behind on version."
• "Which witnesses does nalexadre vote for — and are they all healthy?"

Multi-step

• "Give me a profile of nalexadre: bio, the USD value of their vote, and their latest post with its vote count."
• "Compare nalexadre, megadrive and khrom — stake, reach and earnings — as a table."