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

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_alttext_ai?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/alttext_ai/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/alttext_ai/<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/alttext_ai/skill.md
Postman collection (v2.1): https://mcp.ai/alttext_ai/postman.json

## Tools
- alttext_ai_create_bulk_images(file: object, email?: string) — 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
- alttext_ai_create_image(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[]) — 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
- alttext_ai_delete_image_by_asset_id(asset_id: string) — 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.
- 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.
- alttext_ai_get_image_by_asset_id(asset_id: string) — 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.
- alttext_ai_get_images(url?: string, page?: integer, limit?: integer) — 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.
- alttext_ai_scrape_page(lang?: string, keywords?: string[], page_scrape: object, include_existing?: boolean, negative_keywords?: string[]) — 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
- alttext_ai_search_images(page?: integer, query: string, per_page?: integer) — 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
- alttext_ai_update_account(account: object) — Tool to update account settings (e.g., webhook_url, name). Use after confirming current account details to modify settings.
- alttext_ai_update_image_by_asset_id(lang?: string, image: object, asset_id: string, overwrite?: boolean) — 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.

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

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