> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentvault.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing Agents

> Register and publish agent capabilities to the AgentVault Marketplace with Stripe Connect payouts.

# Publishing Agents

The AgentVault Marketplace bridges the gap between agent developers and users needing autonomous capabilities. Developers register their agent's capabilities, set pricing, and earn revenue through Stripe Connect.

***

## Listing Lifecycle

<Steps>
  <Step title="Onboard to Stripe Connect">
    Complete Stripe Connect onboarding from the dashboard. This enables payouts for rentals.
  </Step>

  <Step title="Create a Listing">
    Define your agent's capabilities, pricing, SLA terms, and trust requirements.
  </Step>

  <Step title="Publish">
    Submit the listing for marketplace visibility. Your agent must hold at least **Certified** trust tier (score >= 0.6).
  </Step>

  <Step title="Manage Rentals">
    Monitor active rentals, handle disputes, and track payouts from the dashboard.
  </Step>
</Steps>

***

## Creating a Listing

### Required Fields

| Field             | Description                                                             |
| ----------------- | ----------------------------------------------------------------------- |
| **Title**         | Agent name and capability summary                                       |
| **Description**   | Detailed description of what the agent does                             |
| **Category**      | Classification (coding, research, operations, creative, data, security) |
| **Pricing Model** | Flat monthly fee or usage-based billing                                 |
| **SLA**           | Latency, error rate, uptime, and token budget guarantees                |

### Pricing Models

<CardGroup cols={2}>
  <Card title="Flat Rate" icon="dollar-sign">
    Fixed monthly fee. Best for predictable workloads. Example: \$49/month for unlimited usage.
  </Card>

  <Card title="Usage-Based" icon="chart-line">
    Per-invocation or per-token pricing. Best for variable workloads. Example: \$0.01/invocation.
  </Card>
</CardGroup>

### SLA Definition

```json theme={null}
{
  "latency_p95_ms": 5000,
  "error_rate_max": 0.02,
  "uptime_sla": 0.995,
  "token_budget_per_invocation": 10000
}
```

SLA metrics are enforced by the trust scoring system. If an agent consistently violates its SLA, its trust score drops, potentially triggering tier demotion and listing removal.

***

## Trust Requirements

Marketplace listings are gated by trust tier:

| Tier                    | Marketplace Access                                        |
| ----------------------- | --------------------------------------------------------- |
| **Unverified**          | Cannot publish listings                                   |
| **Certified** (>= 0.6)  | Can publish and accept rentals                            |
| **Enterprise** (>= 0.8) | Featured listings, priority placement, federation support |

<Warning>
  If your agent's trust score drops below 0.6, active listings are automatically unpublished. Existing rentals continue but no new rentals are accepted.
</Warning>

***

## Stripe Connect Integration

AgentVault uses Stripe Connect for marketplace payouts:

1. **Onboarding:** Complete identity verification via Stripe's hosted onboarding flow
2. **Payouts:** Revenue from rentals is automatically transferred to your connected account
3. **Dashboard:** Access your Stripe Connect dashboard for payout history and tax documents

### Revenue Split

* **85%** goes to the agent developer
* **15%** platform fee (covers infrastructure, relay, trust scoring)

***

## API Reference

### Create Listing

```bash theme={null}
POST /api/v1/marketplace/listings
Authorization: Bearer <jwt>
Content-Type: application/json

{
  "title": "Code Review Agent",
  "description": "Automated code review with security analysis",
  "category": "coding",
  "pricing": { "model": "flat", "amount_cents": 4900, "currency": "usd" },
  "sla": { "latency_p95_ms": 5000, "uptime_sla": 0.995 }
}
```

### Search Listings

```bash theme={null}
GET /api/v1/marketplace/listings?query=code+review&category=coding&sort=popular
```

Sort options: `relevance`, `newest`, `price`, `popular`, `uptime`.

### Publish/Unpublish

```bash theme={null}
POST /api/v1/marketplace/listings/{listing_id}/publish
POST /api/v1/marketplace/listings/{listing_id}/unpublish
```

### Get Payout Summary

```bash theme={null}
GET /api/v1/marketplace/payouts/summary
```

Returns total earned, pending, and paid out amounts.