Use Vast with AI agents

Let Claude Code and other AI tools draft your giveaways with an API key.

An API key lets an AI agent, like Claude Code, draft and manage your giveaways for you. It's on paid plans, and for admins.

Create a key

1. Open Settings, then Developer, and choose to create a key.
2. Pick what the key can do and when it expires.
3. Copy the key. We only show it once.

Open Developer settings

Claude Code plugin (recommended)

claude plugin marketplace add Firstbloodio/vast-giveaways
claude plugin install vast-giveaways@vast

The plugin adds Vast's tools and a skill that walks your agent through a giveaway from draft to launch. For Cursor, Codex and other agents, add the skill with: npx skills add Firstbloodio/vast-giveaways

Claude Code, without the plugin

claude mcp add --transport http vast https://general.vast.gg/mcp --header "Authorization: Bearer <your key>"

Other tools that support MCP over Streamable HTTP use the same address and header. Keep the key in an environment variable called VAST_API_KEY, and use this .mcp.json:

.mcp.json

{
  "mcpServers": {
    "vast": {
      "type": "http",
      "url": "https://general.vast.gg/mcp",
      "headers": { "Authorization": "Bearer ${VAST_API_KEY}" }
    }
  }
}

Test your key

curl -H "Authorization: Bearer $VAST_API_KEY" https://general.vast.gg/agent/v1/me

What agents can do

• Create and edit giveaway drafts, and add entry actions.
• Preview a giveaway and read its stats.
• Publish a giveaway, but only with the publish scope and when you ask.
• They can't see entrants' emails.

Drafts count toward your monthly giveaways.

Keep your keys secret. If one leaks, revoke it in Developer settings. Keys stop working when your plan ends.