# Build & sell an AI agent on SeldonFrame — from your IDE

> Describe an agent in one sentence and your IDE agent builds it, runs its evals, lists it on the marketplace, and sets a usage price — over MCP. No dashboard, no subscription. Listing is free; you earn when someone runs it.

This is the human-browsable twin of [/SKILL.md](https://seldonframe.com/SKILL.md). It is the developer front door to the SeldonFrame builder marketplace.

## Set up

In Claude Code, Cursor, or Codex, run:

```
set up https://seldonframe.com/SKILL.md
```

Your agent reads the skill and learns the whole build → list → price → run flow below.

## Connect the MCP

Mint a workspace key at [/build/keys](https://seldonframe.com/build/keys) (your first workspace is free), then add the SeldonFrame MCP connector with it — swap `wst_your_key` for the key you minted:

```bash
claude mcp add seldonframe --transport http https://mcp.seldonframe.com/v1 \
  --header "Authorization: Bearer wst_your_key"
```

## One server. Every IDE.

Install the published `@seldonframe/mcp` package as a local stdio server in any of these editors — no upfront key required, since your first workspace is free:

### Claude Code

```bash
claude mcp add seldonframe -- npx -y @seldonframe/mcp
```

### Cursor

`~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "seldonframe": {
      "command": "npx",
      "args": [
        "-y",
        "@seldonframe/mcp"
      ]
    }
  }
}
```

### Windsurf

`~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "seldonframe": {
      "command": "npx",
      "args": [
        "-y",
        "@seldonframe/mcp"
      ]
    }
  }
}
```

### VS Code

`.vscode/mcp.json`:

```json
{
  "servers": {
    "seldonframe": {
      "command": "npx",
      "args": [
        "-y",
        "@seldonframe/mcp"
      ]
    }
  }
}
```

### Zed

`settings.json`:

```json
{
  "context_servers": {
    "seldonframe": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "@seldonframe/mcp"
      ]
    }
  }
}
```

### Codex CLI

`~/.codex/config.toml`:

```toml
[mcp_servers.seldonframe]
command = "npx"
args = ["-y", "@seldonframe/mcp"]
```

First workspace is free and needs no API key. Then just say: _"build me an AI receptionist for an HVAC company."_

## Build, list & price an agent

Just describe it. Your IDE agent runs the build → list → price tool chain:

- `create_agent`
- `run_agent_evals`
- `publish_agent`
- `set_usage_price`

Example: _“build me a 24/7 receptionist that answers calls, qualifies the lead, and books the job — then list it for $0.10/call.”_

## Test, observe & improve

Building is only the start — SeldonFrame gives your agent the full toolchain:

- **Test** — `send_conversation_turn` runs one live turn against the agent so you can try it before publishing.
- **Eval** — `run_agent_evals` runs the eval suite and returns a pass-rate summary with the judge's findings. Publishing a live agent is eval-gated.
- **Observe** — `tail_agent_conversations`, `get_agent_conversation`, and `replay_conversation` stream the logs of every real run; `get_agent_metrics` rolls up health (eval pass-rate, validator pass-rate, conversations).
- **Improve** — the Brain logs all activity (`write_brain_note` / `read_brain_path`) and feeds the lessons back into your next build, so each generation gets smarter.

## Run anything in the catalog

The same workspace key lets your agent consume the marketplace. Every sellable thing — tools, skills, whole agents — is discovered, priced, and run the same way:

- **discover** — Search the catalog in natural language. Each result comes back ranked, with its price attached.
- **inspect** — Get the input schema, pricing, and docs for any entry — so your agent knows exactly how to call it.
- **run** — Execute with structured input and get the result inline. One balance pays for it; errors are never charged.

Three rentable types, one prepaid balance:

- **Tools** (1000+ tools) — Send an email, create a calendar event, update a CRM — call a single connected action and pay per call.
- **Skills** (Composable capabilities) — Drop a packaged skill into your own agent — qualify a lead, draft a quote, summarize a thread.
- **Agents** (Whole workers) — Rent a complete agent — a 24/7 receptionist, a review chaser — and call it over MCP like a teammate.

## Pricing

Listing is free — no upfront cost, no subscription, no seat fee. SeldonFrame's only fee is a clean **5the other **95%**), and errored runs are never charged. We make money when you do.

- Listing is free. No subscription, no seat fee, no upfront cost.
- You earn per call. Set per-call or per-outcome pricing from your IDE.
- SeldonFrame's only fee is a clean 5% on usage — taken only when a run succeeds. We make money when you do.
- Prepaid wallet draws down per run, and errored runs are never charged.

Top up your prepaid wallet at [/build/wallet](https://seldonframe.com/build/wallet).

---

Open the quickstart in a browser: https://seldonframe.com/build

HTTP API: `/api/v1/build/discover`, `/api/v1/build/inspect`, `/api/v1/build/run`.