# TwitterShots — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/twittershots

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_twittershots?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/twittershots/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/twittershots/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/twittershots/skill.md
Postman collection (v2.1): https://mcp.ai/twittershots/postman.json

## Tools
- twittershots_generate_temporary_screenshot_url(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) — 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
- twittershots_generate_tweet_screenshot(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) — Render a public tweet or post as an SVG, PNG, or HTML file suitable for saving. A successful render consumes one API credit.
- twittershots_get_api_usage() — Return the remaining and total TwitterShots API credits for the connected API key. This read does not consume a credit.
- twittershots_get_bulk_tweet_content(tweet_ids: string[]) — 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
- twittershots_get_tweet_content(tweet_id: string, include_media?: boolean, include_stats?: boolean, include_quoted?: boolean) — Fetch one public tweet as structured Markdown, with optional statistics, media links, and quoted-tweet content. A successful call consumes one API credit.

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

## Links
Docs: https://mcp.ai/docs/mcps/twittershots
Website: https://mcp.ai/mcps/twittershots