Repository avatar
Other Tools
v1.2.0
active

seller-agent

io.github.lihaoshall/seller-agent

Discover original Chinese book reviews via MCP. Buy full articles for 0.95 USDC on Base.

Documentation

Seller Agent v1.2

Discover original Chinese-language book reviews for free; purchase one complete review for $0.95 USDC on Base mainnet.

Seller Agent is an AI-agent-facing content service built with the Model Context Protocol (MCP) and x402 v2 HTTP payments. The public MCP tools expose catalog metadata and purchase instructions, not the private article text.

Live endpoints

  • MCP server: https://agent-content-store.sthinking.workers.dev/mcp
  • Paid full-article API: POST https://agent-content-store.sthinking.workers.dev/api/purchase-article

Catalog

IDReviewed bookAuthor of reviewed bookTopics
review-001The Nurture AssumptionJudith Rich HarrisChild development, peers, heredity
review-002Guns, Germs, and SteelJared DiamondGeography, history, inequality
review-003Narrative EconomicsRobert J. ShillerEconomic narratives, Bitcoin, automation
review-004The Deficit MythStephanie KeltonModern Monetary Theory, deficits, inflation
review-005The Language InstinctSteven PinkerLanguage, cognition, evolution
review-006The Rise and Fall of American GrowthRobert J. GordonUS productivity, innovation, economic history

All six reviews are original Chinese-language reviews of the books listed above. They are not the books themselves. Free discovery metadata supports Chinese and English queries.

Free MCP tools

  • search_library — Search the public catalog by keywords or natural-language questions; an empty query lists available items.
  • get_purchase_instructions — Get the paid API request format and payment instructions for a selected content_id.

MCP does not deliver private full-article text. Clients must support connecting to a remote MCP endpoint to use these tools.

Buy a full article

Make a JSON POST request (example):

curl -i -X POST "https://agent-content-store.sthinking.workers.dev/api/purchase-article" \
  -H "Content-Type: application/json" \
  -d '{"content_id":"review-003"}'

An unpaid request returns HTTP 402 with an x402 v2 PAYMENT-REQUIRED header. A compatible x402 client can validate the payment requirements, obtain buyer authorization, and retry the same request with a valid payment proof.

Payment parameters:

ParameterValue
Price$0.95 USDC per complete article
NetworkBase mainnet (eip155:8453)
Protocolx402 v2
Schemeexact
TokenUSDC (Base mainnet)
USDC contract0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Amount950000 USDC base units

The PAYMENT-REQUIRED response is the authoritative live payment offer. Buyers should verify network, token, amount, and recipient against trusted expectations before signing. Do not send private keys to this service.

A successful paid request returns JSON with success: true and the full original Markdown in article.content (along with the article's ID, title, language, and source-book metadata).

Purchase semantics: One successful x402 payment authorizes one complete-article HTTP response. Buyers can save the text they receive. This is not a subscription, an account-based permanent entitlement, or DRM.

If a payment attempt times out or fails ambiguously, check settlement status before retrying to avoid accidental duplicate charges.

Service status and scope

This is an early public release with six reviews. The legacy /api/query-content excerpt endpoint has been retired. Article discovery is free; complete articles are paid. This repository contains documentation only—no private reviews, wallets, or backend source code.

No installation packages available.