# Vast

> Vast (vast.gg) runs giveaways. People enter by doing actions such as following an X account, joining a Discord server or visiting a link. Vast tracks entries, writes the official rules and draws the winners. AI agents can draft, publish and track giveaways for a host through Vast's MCP server.

## Run a giveaway with an AI agent

- MCP server (Streamable HTTP): https://general.vast.gg/mcp
- Auth: `Authorization: Bearer <API key>`. The host creates the key at https://vast.gg/settings/developer and keeps it in the `VAST_API_KEY` environment variable. Never ask a person to paste a key into chat.
- Flow: `get_my_plan_limits` → `list_action_types` → `create_giveaway_draft` (with an `idempotency_key`) → `add_entry_actions` → `preview_giveaway` → `publish_giveaway` with `confirm: true`, only when the host asks → `get_entry_stats`.
- Giveaways stay drafts until they're published. Publishing makes a giveaway public.
- End by giving the host a short list of what only they can do, such as upgrading a plan or finishing a step in the web editor.

## Install

- Claude Code plugin: `claude plugin marketplace add Firstbloodio/vast-giveaways`, then `claude plugin install vast-giveaways@vast`
- Agent skill for Claude Code, Cursor, Codex and others: `npx skills add Firstbloodio/vast-giveaways`
- Any MCP client: `claude mcp add --transport http vast https://general.vast.gg/mcp --header "Authorization: Bearer $VAST_API_KEY"`

## Docs

- [Use Vast with AI agents](https://vast.gg/help/use-vast-with-ai-agents): keys, setup and what agents can do
- [Plugin and skill source](https://github.com/Firstbloodio/vast-giveaways)
- [Plans](https://vast.gg/upgrade)
- [Help center](https://vast.gg/help)
- [Privacy policy](https://vast.gg/privacy-policy)