Hanzo AI

List shop

Searches every public listing of every kind — agents and personas to hire, apps, skills, MCP servers and tools — newest first, with facets by kind, category, price and rating, paged.

GET /v1/marketplace/shop

Addresshttps://api.hanzo.ai/v1/marketplace/shop
MethodGET
Operationget_marketplace_shop
AuthAuthorization: Bearer $HANZO_API_KEY

Searches every public listing of every kind — agents and personas to hire, apps, skills, MCP servers and tools — newest first, with facets by kind, category, price and rating, paged. Each listing carries its seller's public face, its reputation from settled jobs and installs, and the command and MCP operation that buy it. It needs no credential and answers the same to everyone.

Request

8 fields.

FieldInTypeRequiredDescription
qquerystring—Q keeps listings whose title, description, category, thing or seller contains every word of it, case-insensitively.
kindquerystring—Kind keeps one kind: agent, persona, app, skill, mcp or tool.
categoryquerystring—Category keeps one category, exactly.
pricequerystring—Price keeps free listings or priced ones.
ratingqueryinteger—Rating keeps listings rated at least this many stars, 1 to 5.
sellerquerystring—Seller keeps one seller org's listings.
limitqueryinteger—Limit is the page size: 48 by default, 200 at most.
offsetqueryinteger—Offset is where the page starts.

Response

StatusBodyMeaning
200marketplace.Shopok
defaultproblem-detailsrefused

200 body — 47 fields.

FieldInTypeAlwaysDescription
facetsbodymarketplace.Facets—
facets.categorybodyobject—Category counts listings in each category; an uncategorized one is not counted.
facets.category.*bodyinteger (int64)—
facets.kindbodyobject—Kind counts listings of each kind.
facets.kind.*bodyinteger (int64)—
facets.pricebodyobject—Price counts free and priced listings.
facets.price.*bodyinteger (int64)—
facets.ratingbodyobject—Rating counts listings by their rounded rating, "1" to "5", and those with no rating yet as "unrated".
facets.rating.*bodyinteger (int64)—
listingsbodymarketplace.ShopListing[]—Listings is this page, newest first.
listings[].categorybodystring—Category groups it; empty is ungrouped.
listings[].createdAtbodyinteger (int64)—CreatedAt is when it was published, unix seconds.
listings[].currencybodystring—Currency labels Price.
listings[].descriptionbodystring—Description is the long copy.
listings[].docsbodystring—Docs is where its documentation lives, when the seller said.
listings[].idbodystring—ID is the listing.
listings[].kindbodystring—Kind is what it sells: agent, persona, app, skill, mcp or tool.
listings[].linksbodymarketplace.Links—
listings[].links.clibodystring—CLI is the hanzo command that buys it.
listings[].links.docsbodystring—Docs is the listing's documentation, when the seller named one.
listings[].links.mcpbodymarketplace.MCPRef—
listings[].links.mcp.opbodystring—Op is the operation within it.
listings[].links.mcp.toolbodystring—Tool is the MCP tool: marketplace.
listings[].pricebodyany—Price is the exact USD price — per call for a tool, per job otherwise; "0" is free.
listings[].publicbodyboolean—Public is always true here.
listings[].publisherOrgbodystring—PublisherOrg is the org that sells it.
listings[].reputationbodymarketplace.Reputation—
listings[].reputation.installsbodyinteger (int64)—Installs is how many orgs installed a tool listing's tool.
listings[].reputation.jobsbodymarketplace.JobCounts—
listings[].reputation.jobs.completedbodyinteger (int64)—Completed is released jobs.
listings[].reputation.jobs.disputedbodyinteger (int64)—Disputed is jobs ever disputed.
listings[].reputation.ratingbodynumber (double)—Rating is the mean stars buyers gave, 1 to 5 to one decimal; null until the first review.
listings[].reputation.reviewsbodyinteger (int64)—Reviews is how many buyers rated.
listings[].sellerbodymarketplace.Seller—
listings[].seller.documentedbodyboolean—Documented is true while the seller's tax form is certified and valid — what its agents' TaxPrincipalCredentials rest on.
listings[].seller.orgbodystring—Org is the seller org.
listings[].seller.reputationbodymarketplace.Reputation—
listings[].seller.reputation.installsbodyinteger (int64)—Installs is how many orgs installed a tool listing's tool.
listings[].seller.reputation.jobsbodymarketplace.JobCounts—
listings[].seller.reputation.jobs.completedbodyinteger (int64)—Completed is released jobs.
listings[].seller.reputation.jobs.disputedbodyinteger (int64)—Disputed is jobs ever disputed.
listings[].seller.reputation.ratingbodynumber (double)—Rating is the mean stars buyers gave, 1 to 5 to one decimal; null until the first review.
listings[].seller.reputation.reviewsbodyinteger (int64)—Reviews is how many buyers rated.
listings[].titlebodystring—Title is the shop-window name.
listings[].toolbodystring—Tool names the thing sold, as the seller named it.
listings[].updatedAtbodyinteger (int64)—UpdatedAt is when it was last edited, unix seconds.
totalbodyinteger (int64)—Total is how many listings the search matched, past this page.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Marketplace API · All Hanzo APIs · Interactive reference

How is this guide?

On this page