DEVELOPERSDocumentation

Build, list, get paid.

Everything you need to publish a skill, agent, MCP server, or x402 endpoint to the marketplace. Written for humans who write code, not for SEO.

QUICKSTART
Publish in 4 min
From `npm init` to first listing. The 80% path.
Read →
x402
Per-call payments
HTTP 402 settle, EIP-3009, refund flow.
Read →
MCP
Hosted servers
Spec-compliant publishing, manifest fields.
Read →
SKILLS
Skill packaging
SKILL.md, scripts/, license headers.
Read →
AGENTS
Subagents
Tool whitelists, scopes, audit logs.
Read →
CLI
`marketplace` CLI
Auth, publish, scan, payout commands.
Read →
SDK
TypeScript SDK
`@marketplace/sdk` — buyer + seller APIs.
Read →
WEBHOOKS
Events
sale.created, refund.issued, scan.completed.
Read →
SCAN
Auto-scan API
CI integration, badge embeds.
Read →

/01Quickstart — publish in 4 minutes

Install the CLI, log in with your wallet, then run publish. The CLI infers your asset type from the working directory.

$ npm i -g @marketplace/cli
$ marketplace login
→ open https://clidora.dev/auth/...
→ wallet connected: 0x4f...8a91

$ cd ~/code/web-fetch-skill
$ marketplace publish --price 12 --refund 48h
→ packaging SKILL.md + scripts/ ... ok
→ auto-scan ... 0 critical, 0 high
→ uploaded to ipfs://bafy...kk4u
→ live: clidora.dev/skill/web-fetch

/02API reference index

POST
/v1/listings
Create a new listing of any type
GET
/v1/listings/{id}
Read a listing + scan status
POST
/v1/listings/{id}/publish
Move from draft → live
POST
/v1/x402/settle
Settle a buyer call (server SDK uses this)
POST
/v1/refunds
Issue a refund against a receipt
GET
/v1/sales
Paginated sales for the auth’d seller
POST
/v1/scan
Trigger an out-of-band auto-scan
GET
/v1/payouts
List USDC settlements + tx hashes

/03SDK example — settle a per-call payment

// server.ts — your agent endpoint
import { x402 } from '@marketplace/sdk';

app.post('/run', x402.guard({ price: 0.004 }), async (req, res) => {
  const result = await runAgent(req.body);
  // payment is already settled when this line runs
  res.json(result);
});
→
Need help? Open a thread.
Most quickstart questions get answered in under 2 hours by email. [email protected]