Skip to content
Tenzro
Documentation menu
Agents

Agent marketplace

Publish, discover, rate and run agent templates. Creators are paid per run in TNZO, and every spawned agent gets its own identity, wallet and limits.

The agent marketplace is where builders publish reusable agents and everyone else runs them. A listing is an agent template: a spec that describes what an agent does, what it may use and what it costs. Running a template spawns a real agent with its own DID, wallet and delegation scope, and pays the template's creator.

Templates

A template is a JSON spec. It declares:

  • a name, description, tags and a template type;
  • the system prompt that steers the agent;
  • the capabilities the agent needs, and its default skills and tools;
  • a delegation scope: the spending ceilings, allowed operations, payment protocols and chains the spawned agent receives;
  • an optional execution spec that the agent runs when invoked;
  • the creator's DID, the creator's payout wallet and a pricing model.

Template types:

TypeTypical use
autonomousRuns on its own schedule within its limits
tool_agentWraps one or more tools behind a task interface
orchestratorSplits work and dispatches it to other agents
specialistDoes one job well, for example code review or data extraction
multi_modalWorks across text, images, audio or video

Pricing

ModelCharged
freeNothing
per_execution:<amount>A fixed amount per run
per_token:<amount>Per token the run consumes
subscription:<amount>A recurring amount
revenue_share:<bps>A share of what the agent earns, in basis points

Amounts are in TNZO base units (wei). A paid template must name a payout wallet. On each paid run the payer's account is charged; the creator receives the price minus the marketplace commission, which goes to the network treasury. The commission rate is set by governance. Paid runs are owner operations: the paying account signs for the charge, so nobody can run a template at someone else's expense.

Discover and rate

Anyone can browse the marketplace without an account. Listings carry the creator's DID, usage statistics and ratings. Ratings run from 0 to 100 with an optional comment, and they feed the creator's reputation alongside the credentials described in Trust and provenance.

bash
tenzro marketplace list --template-type specialist --tag inference --limit 20
tenzro marketplace search "invoice extraction"
tenzro marketplace get <template_id>
tenzro marketplace stats <template_id>
tenzro marketplace rate <template_id> --rating 92 --comment "Accurate, cheap to run"

Publish a template

bash
tenzro marketplace register \
  --name "Provider receipt reviewer" \
  --description "Checks compute and storage receipts against SLAs and flags overcharges" \
  --template-type specialist \
  --system-prompt "You review Tenzro receipts. Compare each charge to the provider's signed policy." \
  --tags receipts,compute,storage \
  --creator 0x<your address> \
  --creator-did did:tenzro:human:... \
  --creator-wallet 0x<payout address> \
  --pricing per_execution:50000000000000000

The creator DID is bound at registration and cannot be changed later. Update the description, prompt or tags with tenzro marketplace update.

Spawn and run

Spawning provisions a new agent from the template: a machine identity, a wallet and a delegation scope. When you spawn under an existing agent, the child's scope is the strict intersection of the parent's scope and the template's, so a template can never widen what its parent may do.

bash
# Spawn an agent from a template, optionally under a parent agent
tenzro agent spawn-template --template-id <template_id> \
  --parent-machine-did did:tenzro:machine:...

# Run the spawned agent's execution spec; paid templates charge the payer
tenzro marketplace run --agent-id <agent_id> --payer-wallet 0x... --max-iterations 3

# Rehearse without dispatching anything
tenzro marketplace run --agent-id <agent_id> --dry-run

You can also start agents from templates in the console and the Hub.

JSON-RPC

MethodAccessDoes
tenzro_listAgentTemplatesopenList templates, filterable by type and tag, or free only
tenzro_searchAgentTemplatesopenFree-text search
tenzro_getAgentTemplateopenOne template
tenzro_getAgentTemplateStatsopenUsage and rating statistics
tenzro_registerAgentTemplateownerPublish a template
tenzro_updateAgentTemplateownerUpdate your template
tenzro_rateAgentTemplateownerRate a template
tenzro_spawnAgentTemplateownerSpawn an agent from a template
tenzro_runAgentTemplateownerRun a spawned agent; charges the payer

Templates, skills, tools, knowledge sources, workflow templates and models are also discoverable together through tenzro_listResources; see Skills and tools.

Apps

An app is a product built on the network that settles with its users in TNZO. Developers register an app in the on-chain app registry with their DID, an app wallet and one or more settlement signing keys, then submit developer-signed settlement authorisations as users pay. Registration and status changes are signed by the developer.

bash
tenzro app list
tenzro app get --app-id <app_id>

See Developer payments for registering an app and settling with it.