human marketplace

The human marketplace command family covers two audiences:

Audience	Commands	Purpose
Consumers	search, browse, install	Find and install connectors/agents from the public catalog
Authors	init, lint, review, publish, …	Scaffold and submit your own marketplace assets

Consumer commands — finding agents to use

Use these when you want to extend your org with an existing marketplace asset (ECC-01.3).

human marketplace search

Search the public catalog by keyword and/or capability.

human marketplace search "invoice processing"
human marketplace search --capability document.extract --trust-tier certified
human marketplace search "email" --limit 10 --json

Flag	Description
--capability <cap>	Capability id filter (e.g. document.extract)
--trust-tier <tier>	community, certified, or verified
--limit <n>	Max results (default 20)
--json	Machine-readable JSON

When logged in, the results table includes a Compat column: ✔ when your delegation likely covers the connector capabilities, ⚠ when additional scopes may be required, — when not authenticated.

When no results match an exact capability, the CLI may suggest a broader capability prefix (e.g. document instead of document.extract.v2).

human marketplace browse

Browse a terminal tree of capability domains → capabilities → marketplace providers.

human marketplace browse
human marketplace browse --domain document
human marketplace browse --json

Flag	Description
--domain <domain>	Narrow to one domain (e.g. document, communication)
--json	Raw capability map JSON

human marketplace install

Install a connector into your org. Requires human login (delegation token).

human login
human marketplace install invoice-parser
human marketplace install brand-voice-director --org did:org:acme

Flag	Description
--org <org-did>	Verify the active delegation token is scoped to this org DID (must match the org from human login or HUMAN_DELEGATION_TOKEN; does not override the token)

On success prints either ✔ <Name> ready. or ✔ <Name> installed. Setup required: <url> when OAuth setup is needed.

Author commands — publishing assets

Command	Description
human marketplace init	Scaffold human-agent.yaml + README
human marketplace lint	Validate manifest and OpenAPI extensions
human marketplace review	Local review checks before submit
human marketplace preview	Preview listing metadata
human marketplace test	Run manifest tests
human marketplace package	Package asset for upload
human marketplace sign	Sign marketplace artifact
human marketplace publish	Submit for marketplace review

Prompt Safety Certification (Check #15)

Third-party agents declare prompts in agent_prompt_contributions. Check #15 scans prompt files at review time and stores a public-safe prompt_certification object on the listing (SHA-256 per prompt_uri, trust-boundary summary, finding codes — no prompt bodies).

human marketplace review --prompts-dir .

JSON output includes promptCertification when checks pass. Example shape:

{
  "check_id": 15,
  "aggregate_status": "pass",
  "prompt_count": 1,
  "prompts": [
    {
      "prompt_uri": "prompt://org/acme/demo/system",
      "content_sha256": "<sha256-hex>",
      "defense_baseline": true,
      "structural_scan": "pass"
    }
  ]
}

API: POST /v1/marketplace/review accepts source_bundle_path and prompts_dir. Failed Check #15 blocks POST /v1/marketplace/submit with 422 and the full review report.

Deep dive: Certifying marketplace prompts without exposing IP.

MCP tools (@human/mcp)

Connect your org mesh at https://{org-slug}.mcp.haio.run/mcp (Streamable HTTP) or run npx @human/mcp with HUMAN_ORG_ENDPOINT and a delegation token. Then in Cursor or Claude Code:

Tool	When to use
human.marketplace.search	Keyword/capability search in the IDE
human.marketplace.capability-map	Browse domains and providers
human.marketplace.connector.get	Full manifest before install
human.marketplace.install	Install into your org (auth required)
human.marketplace.workflows.list	List org workflows

vs. human.capability.query / human.capability.search: those query the capability graph (what passports/org profiles already have). Marketplace tools find and install new assets from the catalog.

See also: Platform discovery — GET /v1/discover lists marketplace entry points and discovery_tips.