# market

> Reference for the market tool: browse, install, buy, publish and withdraw marketplace listings. Checkout is mocked.

Source: https://prompt-verse.io/docs/reference/market/

Listings are committed versions of prompts, agents and workflows. A listing points at a commit, so installs never change under their owners.

Call it as `geenius_promptverse(tool: "market", action: "<action>", args: {...})` through Geenius OS, or as the `market` tool of the Prompt Verse MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `browse` | Published listings. |
| `read` | One listing by slug. |
| `install` | A private copy at the published version. |
| `buy` | Buy a paid listing. The checkout is mocked until payments open, and the answer says so. |
| `publish` | List a committed version. A price above zero makes it paid. |
| `withdraw` | Take your own listing down. Installs keep their copy. |
| `try` | Run a listing without installing it. Switched off in the pre-beta. |

## Arguments we have checked

### market · browse

Published listings.

- `entity_type`: Optional kind.
- `tag`: Optional tag.
- `q`: Optional phrase.
- `limit`: Optional cap.

### market · read

One listing by slug.

- `slug` (required): Listing slug.

### market · install

A private copy at the published version.

- `slug` (required): Listing slug.

### market · buy

Buy a paid listing. The checkout is mocked until payments open, and the answer says so.

- `slug` (required): Listing slug.

### market · publish

List a committed version. A price above zero makes it paid.

- `entity_type` (required): prompt, workflow or agent.
- `entity_id` (required): Its id.
- `commit_id` (required): From versions commit.
- `title` (required): Listing title.
- `summary`: One line.
- `tags`: Tags.
- `price_cents`: Optional price in cents.

### market · withdraw

Take your own listing down. Installs keep their copy.

- `slug` (required): Listing slug.

### market · try

Run a listing without installing it. Switched off in the pre-beta.

- `slug` (required): Listing slug.
- `variables`: Inputs.
- `model_id`: Optional model id.

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "browse"`. The server answers from its own definitions, so that answer is always current.

> [!HONEST]
> Paid checkout is mocked in the pre-beta: no real money moves. try is listed but refuses while the AI features are off.