# TwitterShots — how to use (mcp.ai)

Connect your TwitterShots account and use 5 tools for images and design straight from your AI agent. Connect with your own API key. TwitterShots renders public X posts as screenshots and retrieves tweet content and API usage.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_twittershots?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `twittershots_generate_temporary_screenshot_url`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/twittershots`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/twittershots/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/twittershots/generate/temporary/screenshot/url` — Render a public tweet or post and return a provider-hosted temporary URL. Download the result promptly or use Generate Tweet Screenshot when it must be retained. A successful render consumes one API c
  - body: { logo?: string, theme?: string, width?: integer, format?: string, height?: integer|string, tweet_id: string, show_media?: boolean, show_stats?: boolean, show_views?: boolean, aspect_ratio?: string, media_layout?: string, border_radius?: number, show_full_text?: boolean, show_timestamp?: boolean, background_image?: string, time_zone_offset?: string, container_padding?: number, container_background?: string }
- `POST https://api.mcp.ai/api/twittershots/generate/tweet/screenshot` — Render a public tweet or post as an SVG, PNG, or HTML file suitable for saving. A successful render consumes one API credit.
  - body: { logo?: string, theme?: string, width?: integer, format?: string, height?: integer|string, tweet_id: string, show_media?: boolean, show_stats?: boolean, show_views?: boolean, aspect_ratio?: string, media_layout?: string, border_radius?: number, show_full_text?: boolean, show_timestamp?: boolean, background_image?: string, time_zone_offset?: string, container_padding?: number, container_background?: string }
- `POST https://api.mcp.ai/api/twittershots/get/api/usage` — Return the remaining and total TwitterShots API credits for the connected API key. This read does not consume a credit.
- `POST https://api.mcp.ai/api/twittershots/get/bulk/tweet/content` — Fetch up to 100 public tweets as one Markdown document. Inspect the returned Markdown for a 'Failed to fetch tweets' section because individual IDs can fail within an HTTP 200 response. A successful b
  - body: { tweet_ids: string[] }
- `POST https://api.mcp.ai/api/twittershots/get/tweet/content` — Fetch one public tweet as structured Markdown, with optional statistics, media links, and quoted-tweet content. A successful call consumes one API credit.
  - body: { tweet_id: string, include_media?: boolean, include_stats?: boolean, include_quoted?: boolean }

## Example prompts
- "What can I do in TwitterShots?"
- "Show me a summary of my TwitterShots account"

## More
- Page: https://mcp.ai/twittershots
- Agent spec (llms.txt): https://mcp.ai/twittershots/llms.txt
- Postman collection: https://mcp.ai/twittershots/postman.json