# FlyWheel

> FlyWheel is the audited ad-ops layer for AI agents. One MCP server gives your
> agent read+write access to Google Ads (live), Reddit, Meta, TikTok, X, and
> LinkedIn (planned). Every tool call is logged to a queryable audit trail.
> Built for builders, agencies, and ops teams running real ad spend through agents.

## Install

Claude Code:
  claude plugin install flywheel

Generic MCP client:
  Endpoint: https://connector.flywheelagents.com/api/mcp
  Auth:     Authorization: Bearer fw_live_<key>
  Get a key: hello@flywheelagents.com (private beta)

## Slash commands (Claude Code)
- /flywheel:connect:google      OAuth into a Google Ads account
- /flywheel:campaigns:list      list campaigns
- /flywheel:campaigns:search    search by name / status
- /flywheel:campaign:stats      performance metrics
- /flywheel:campaign:create     create a campaign (defaults to paused)
- /flywheel:ad-group:create     create an ad group
- /flywheel:ad:create           create an ad

## MCP tools (programmatic names)
- campaigns_list, campaigns_search, campaign_stats
- campaign_create, ad_group_create, ad_create
- writes default to paused; deletion not exposed in v0.1

## Platforms
- Google Ads (live, private beta)
- Reddit Ads, Meta, TikTok, X, LinkedIn (planned)

## Safety
- OAuth tokens encrypted at rest (AES-256-GCM)
- Every tool call logged with args, status, latency, actor
- Writes default to paused state
- API keys are revocable

## Links
- Site:      https://flywheelagents.com
- Contact:   hello@flywheelagents.com
- Privacy:   https://flywheelagents.com/privacy
- Terms:     https://flywheelagents.com/terms
- Security:  https://flywheelagents.com/.well-known/security.txt
- MCP info:  https://flywheelagents.com/.well-known/mcp.json