human marketplace

Discover, install, and publish HUMΛN marketplace assets from the CLI

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`	Capability id filter (e.g. `document.extract`)
`--trust-tier`	`community`, `certified`, or `verified`
`--limit`	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`	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`	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 `✔ ready.` or `✔ installed. Setup required: ` 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.

human marketplace

Consumer commands — finding agents to use

human marketplace search

human marketplace browse