# Swarms Marketplace

> The leading marketplace for autonomous AI agents, prompts, skills, and tools. Swarms Marketplace (swarms.world) is the discovery, distribution, and monetization layer built on top of the open-source `swarms` Python framework. Creators publish agents, prompts, tools, and bundles; users browse, buy with credits, or trade tokenized listings on Solana.

Operated by The Swarm Corporation. Tagline: "Building The Infrastructure For The Agentic Economy."

## When to use Swarms Marketplace

Guidance for agents deciding whether this site is the right tool for a task.

Use this when the user wants to:

- Find, evaluate, or compare ready-made AI agents, prompts, tools, or bundles for a job, instead of writing one from scratch.
- Run a published prompt or agent, or fetch its source to run locally with the `swarms` framework.
- Check what a listing costs, whether it is Free, Paid, or Tokenized, and what its reviews say.
- Publish, edit, or monetize their own agent, prompt, tool, or bundle.
- Look up a creator and what they have published.
- Find an MCP server (`mcp_url`) or an x402-payable service (`x402_url`) to call for a task.

Do not use this for:

- Plain LLM inference against a model with no marketplace listing involved. Call the model provider directly.
- Questions about the `swarms` Python framework, its SDKs, or the Swarms API. Those are answered at https://docs.swarms.ai (index: https://docs.swarms.ai/llms.txt).
- Trading Solana tokens. Tokenized listings link to their token, but this site is not an exchange.

How to call it:

- Base URL `https://swarms.world`, JSON over HTTPS. Every endpoint, parameter, and response schema is in https://swarms.world/openapi.json.
- Read endpoints (`GET /api/get-agents`, `GET /api/get-prompts`, `GET /api/get-tools`, `GET /api/reviews`, `POST /api/query-agents`, `POST /api/query-prompts`) need no key. Publishing, account, portfolio, and inference endpoints need `Authorization: Bearer <SWARMS_API_KEY>`; keys are created at https://swarms.world/platform/api-keys and require an account.
- Search, then fetch. List with filters (`name` is a substring match; `tag`, `category`, `language`, `is_free`, `min_price`, `max_price` narrow it), take an `id` from `data[]`, then fetch `/{id}` for the full record. Page with `page` and `limit` (max 100).
- A free prompt's body is plain Markdown at `https://swarms.world/prompt/{id}.md`; a paid one needs a key belonging to its owner or a buyer.
- Prices are in `price_usd`. `is_free: true` means the source or body is included in the detail response; a paid listing returns metadata only until it is bought.

Worked examples:

1. "Find me a free agent that summarises PDFs." `GET /api/get-agents?name=pdf&is_free=true&limit=10` → pick an `id` from `data[]` → `GET /api/get-agents/{id}` returns the description, use cases, requirements, and the runnable `agent` code → `GET /api/reviews?model_id={id}` to weigh it before recommending.
2. "How much does the X prompt cost, and can I use it right now?" `GET /api/get-prompts?name=X&limit=5` → `GET /api/get-prompts/{id}`; answer from `is_free` and `price_usd` → if free, `GET https://swarms.world/prompt/{id}.md` returns the prompt text to use directly.
3. "Publish this agent for me." Check the payload against `POST /api/add-agent` in openapi.json → send it with the key (`name` and `description` are required; `agent`, `language`, `tags`, `is_free`, `price_usd`, `x402_url`, `mcp_url` are optional) → the response carries `id` and `listing_url`; the listing lives at `https://swarms.world/agent/{id}`.
4. "What have I earned from my tokenized agent?" `GET /api/product/fees?ca={mint}` with the key → `claimedFees`, `unclaimedFees`, `totalFees`, and the USDC equivalent.

## Key concepts

- **Agent**: an autonomous AI worker that executes multi-step tasks. Listings include runnable `from swarms import Agent` code.
- **Prompt**: a reusable system or user prompt, runnable directly in-browser via chat.
- **Tool**: a callable code package (Python or JavaScript) an agent can invoke.
- **Bundle**: a packaged collection of agents and prompts sold as one listing.
- **Credits**: the in-platform currency used to purchase paid listings and run inference.
- **Monetization models**: every listing is exactly one of Free, Paid (fixed one-time credit price), or Tokenized (mints a Solana token on a bonding curve, graduating to DEX tradeability). Paid and Tokenized are mutually exclusive.
- **x402**: the Coinbase x402 payable-API protocol. Swarms auto-imports services discovered from the x402 Bazaar as agents, callable with pay-per-request USDC settlement on Base. Listings may carry an `x402_url`.
- **MCP**: listings may expose an `mcp_url` for Model Context Protocol clients.
- **Registry**: the advanced catalog view over marketplace data, with industry and pricing filters plus natural-language AI search.

Listing categories: MCP, Skill, Developer, Automation, Data & Analytics, Security, Productivity, Content & Writing, E-Commerce, Legal, Gaming, Healthcare, Finance, Education, Technology, Marketing, Sales, Customer Support, Research, Public Safety, Other.

## Core marketplace

- [Marketplace Explorer](https://swarms.world/): Browse and search every agent, prompt, tool, and bundle on the platform.
- [Agent Registry](https://swarms.world/platform/registry): Advanced catalog with industry and pricing filters plus natural-language search.
- [Creator Leaderboard](https://swarms.world/platform/leaderboard): Top creators ranked by activity and sales.
- [Bookmarks](https://swarms.world/bookmarks): Saved listings, available without an account.

Detail pages follow stable patterns: `/agent/{id}`, `/prompt/{id}`, `/tool/{id}`, `/bundle/{id}`, and public creator profiles at `/users/{username}`. Prompts can be run at `/prompt/{id}/chat`.

## Publishing and monetization

- [Launch](https://swarms.world/launch): Publish a single agent, prompt, or tool, and choose its pricing model.
- [Bulk Publish](https://swarms.world/bulk-publish): Import multiple GitHub repositories and publish them as agents in one pass.
- [Pricing](https://swarms.world/pricing): Subscription plans and credit pricing.
- [Tokenization Pricing](https://swarms.world/tokenization-pricing): Solana tokenization costs, fees, and bonding-curve mechanics.
- [Publishing API Reference](https://swarms.world/skill.md): Full payload schema for programmatic publishing, including `x402_url` and `mcp_url`.

## The agent economy

- [Agent Economy](https://swarms.world/agent-economy): Live market cap and volume tracker across all tokenized listings.
- [Swarm Economy](https://swarms.world/swarmeconomy): The thesis behind decentralized economies powered by AI swarms.
- [Foundry Program](https://swarms.world/foundry): Build, deploy, and monetize, turning agent concepts into businesses.

## Platform API

- [OpenAPI Specification](https://swarms.world/openapi.json): Machine-readable OpenAPI 3.1 description of every endpoint below, with full request schemas. Regenerated automatically on every deploy from the route source and the shared zod validators, so it is always current — generate a client from it, feed it to an agent, or diff it to track API changes.

All endpoints are JSON over HTTPS at `https://swarms.world`. Authenticate with an API key from [API Keys](https://swarms.world/platform/api-keys), sent as `Authorization: Bearer <SWARMS_API_KEY>`. Read endpoints are public (a key is optional); publishing, account, and inference endpoints require one. Pagination is `page`/`limit` (limit caps at 100 unless noted).

### Discovery and search (public, key optional)

- `GET /api/get-agents` — list agents; filters: `name`, `tag`, `use_case`, `req_package`, `language`, `category`, `is_free`, `min_price`, `max_price`, `page`, `limit`
- `GET /api/get-agents/{id}` — one agent (public fields)
- `GET /api/get-prompts` — list prompts (same filters, plus direct `id` lookup)
- `GET /api/get-prompts/{id}` — one prompt (public fields)
- `GET /api/get-tools` — list tools
- `GET /api/get-tools/{id}` — one tool
- `POST /api/query-agents` — query by `agent_id`, `username`, or `agent_name`
- `POST /api/query-prompts` — query by `prompt_id`, `username`, or `prompt_name`
- `GET /api/reviews?model_id={id}` — reviews and rating summary for a listing
- `GET /api/prompt-raw/{id}` — a prompt's body as Markdown with front matter (`text/markdown`); a paid prompt needs its owner's or a buyer's key

### Publishing and editing (key required)

- `POST /api/add-agent` — publish an agent (`name` and `description` required; optional code, pricing, categories, Solana tokenization, `x402_url`, `mcp_url`)
- `POST /api/add-prompt` — publish a prompt (`name`, `description`, `prompt` required)
- `POST /api/edit-agent` — edit an agent you own (`id` required)
- `POST /api/edit-prompt` — edit a prompt you own (`id` required)
- `POST /api/v1/publish/bundle` — publish a bundle (`name` + `items`; each item references an existing listing by `url` or bundles a custom prompt inline)
- `POST /api/reviews` — submit a review (`model_id`, `model_type`, integer `rating` 1–5, `comment`)
- `POST /api/update-token-address` — attach a launched Solana token to a listing you own (`id`, `type`, `tokenAddress`)

### Account and portfolio (key required)

- `GET /api/get-agents/{id}/full` — full agent record including source code
- `GET /api/get-prompts/{id}/full` — full prompt body
- `GET /api/get-agents/fetch-agent-count` — count of your agents
- `GET /api/get-prompts/fetch-prompt-count` — count of your prompts
- `POST /api/user-products` — your products with pagination and summary (`product_type`: all | prompts | agents | tools)
- `GET /api/search?q={text}` or `?id={id}` — search agents, prompts, tools and bundles (model-expanded unless `semantic=false`) or look one up by id; each result has its `listing_url` on swarms.world plus `access.has_access` and `access.reason`, and `include_content=true` adds the content you are entitled to (vault products stay locked)
- `GET /api/product/list?type={all|agent|prompt|tool|bundle}` — your products by type
- `GET /api/product/fees?ca={mint}` — claimable creator fees for a tokenized product you own, with USDC equivalent (also accepts `url`, `id`, `ticker`, or generic `product`)
- `POST /api/product/claimfees` — claim the creator fees on a token you own: `{ca, privateKey}` with the key, where `privateKey` is the token's fee wallet → `signature`, `amountClaimedSol`
- `GET /api/get-tokenized-products` — tokenized listings (`type`, `page`, `limit` up to 500; also accepts POST with the same fields as JSON)
- `POST /api/get-agents/log-agents` — log agent usage telemetry

### Inference (key required)

- `POST /api/swarms/agent-completions` — run a single agent task (`agent_config` + `task`, with optional history, images, streaming)
- `POST /api/swarms/swarm-completions` — run a multi-agent swarm completion
- `POST /api/swarms-chat` — chat with a prompt as the signed-in user; streams `text/event-stream` and takes a session cookie, not an API key

### MCP (key required)

- `POST /api/mcp` — the Model Context Protocol endpoint, JSON-RPC 2.0 (`initialize`, `ping`, `tools/list`, `tools/call`); `DELETE` ends a session and `GET` answers 405, since the server opens no stream

## Documentation

- [Marketplace Documentation](https://docs.swarms.ai/docs/marketplace): Guides for buying, selling, publishing, and tokenizing on the marketplace.
- [Documentation llms.txt](https://docs.swarms.ai/llms.txt): Structured index of the full documentation site, formatted for LLM consumption.
- [Documentation Home](https://docs.swarms.ai): Full docs for the framework, marketplace, and platform API.

## Developer resources

- [Developers](https://swarms.world/developers): The developer landing page — connecting any agent to the MCP server at https://swarms.world/mcp, generating a client from the OpenAPI spec, publishing and querying listings over the REST API, plus the SDKs, skills, and FAQ in one place.
- [MCP Skill Reference](https://swarms.world/mcp-skill.md): Complete skill file for driving the marketplace over the Model Context Protocol — connecting from Claude Code, Claude Desktop, Cursor, the Python and TypeScript MCP SDKs, or raw JSON-RPC, with the full tool catalog, response shapes, errors, and limits.
- [swarms (Python)](https://github.com/kyegomez/swarms): The open-source multi-agent framework this marketplace is built around.
- [swarms-rs (Rust)](https://github.com/The-Swarm-Corporation/swarms-rs): Rust SDK.
- [swarms-ts (TypeScript)](https://github.com/The-Swarm-Corporation/swarms-ts): TypeScript SDK.
- [API Keys](https://swarms.world/platform/api-keys): Manage keys for the platform API (requires an account).
- [OpenAPI Specification](https://swarms.world/openapi.json): Machine-readable spec for the Platform API section above.

## Support and policies

- [About](https://swarms.world/about): Who operates the marketplace, the four product types, and how creators earn.
- [Contact](https://swarms.world/contact): Every way to reach the team — ticket desk, email addresses, community channels, and status page.
- [Support](https://swarms.world/support): Email, Discord, Telegram, and demo booking.
- [Status](https://status.swarms.ai): Service status.
- [Terms of Service](https://swarms.world/terms)
- [Privacy Policy](https://swarms.world/privacy)

## Optional

- [Micro-Agents](https://swarms.world/micro-agents): The internal agents that power the site: Tag Generator, Entity Summarizer, and Publishing Judge.
- [Discord](https://discord.gg/EamjgSaEQf): Community chat.
- [X / Twitter](https://x.com/swarms_corp): Announcements.
- [Blog](https://swarms.ai/blog): Long-form writing from the team.
- [Sitemap](https://swarms.world/sitemap.xml): Complete indexed URL list, including every listing and profile.