# AltText.ai — how to use (mcp.ai)

Connect your AltText.ai account and use 10 tools for artificial intelligence straight from your AI agent. Connect with your own API key. AltText.ai is a service that automatically generates alt text for images, enhancing accessibility and SEO.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_alttext_ai?ms=1787293440000`
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. `alttext_ai_create_bulk_images`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/alttext_ai`
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/alttext_ai/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/alttext_ai/create/bulk/images` — Tool to bulk upload and process a CSV file of image URLs for alt text generation. Use when you need to process multiple images at once (up to 100,000 URLs). Invalid rows are returned in row_errors for
  - body: { file: object, email?: string }
- `POST https://api.mcp.ai/api/alttext_ai/create/image` — Tool to add an image and generate alt text. Supports both URL and base64-encoded file upload. Use when you need to generate alt text for images, with options for custom prompts, keywords, multiple lan
  - body: { lang?: string, ecomm?: object, image: object, keywords?: string[], max_chars?: integer, overwrite?: boolean, async_mode?: boolean, gpt_prompt?: string, model_name?: string, webhook_url?: string, timeout_secs?: integer, keyword_source?: string, negative_keywords?: string[] }
- `POST https://api.mcp.ai/api/alttext_ai/delete/image/by/asset/id` — Tool to delete an image from your library by its asset ID. Use when you need to remove a specific image permanently from your AltText.ai account.
  - body: { asset_id: string }
- `POST https://api.mcp.ai/api/alttext_ai/get/account` — Tool to retrieve account settings and usage information. Use when you need to check your AltText.ai account configuration and usage limits before generating alt text.
- `POST https://api.mcp.ai/api/alttext_ai/get/image/by/asset/id` — Tool to retrieve detailed information about a specific image using its asset ID. Use when you need to fetch alt text, metadata, or status of a previously processed image.
  - body: { asset_id: string }
- `POST https://api.mcp.ai/api/alttext_ai/get/images` — Tool to retrieve a paginated list of images in your library, including their alt text and metadata. Use when you need to browse or filter images programmatically after authentication.
  - body: { url?: string, page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/alttext_ai/scrape/page` — Tool to scrape a web page or HTML document and queue all images for alt text generation. Images are processed asynchronously. Does not execute JavaScript. Use when you need to batch-process images fro
  - body: { lang?: string, keywords?: string[], page_scrape: object, include_existing?: boolean, negative_keywords?: string[] }
- `POST https://api.mcp.ai/api/alttext_ai/search/images` — Search for images in your AltText.ai library by keywords. Searches through your previously processed images to find matches based on URLs, alt text content, and metadata. Useful for finding specific i
  - body: { page?: integer, query: string, per_page?: integer }
- `POST https://api.mcp.ai/api/alttext_ai/update/account` — Tool to update account settings (e.g., webhook_url, name). Use after confirming current account details to modify settings.
  - body: { account: object }
- `POST https://api.mcp.ai/api/alttext_ai/update/image/by/asset/id` — Tool to update an image with new data including asset ID, alt text, and metadata. Use when you need to modify existing image information. Note: You cannot update the URL of an existing image.
  - body: { lang?: string, image: object, asset_id: string, overwrite?: boolean }

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

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