Alttext-mcp Server

An MCP server that lets AI assistants generate alt text, manage image libraries, and queue alt text generation for web page images using the AltText.ai API.

Local serverstdioMIT

What is the Alttext-mcp Server?

alttext-mcp is an MCP project maintained in the alttextai/alttext-mcp repository. The maintainer describes its purpose as “An MCP server that lets AI assistants generate alt text, manage image libraries, and queue alt text generation for web page images using the AltText.ai…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @alttext_ai/alttext-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares ALTTEXT_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_account	Check your credit balance, usage, and account settings.
update_account	Update account name, webhook URL, or notification email.
generate_alt_text	Generate alt text for an image URL. Supports multilingual output, custom prompts, keywords, and character limits. Uses account credits.
generate_alt_text_from_file	Generate alt text from a local image file. Automatically base64-encodes and uploads. Uses account credits.
translate_image	Add alt text in a new language for an existing image (by asset_id). Uses account credits.
list_images	List images in your library with pagination.
search_images	Search your image library by alt text content.
get_image	Get details for a specific image by asset ID.
update_image	Update alt text, tags, or metadata for an image.
delete_image	Delete an image from your library.
bulk_create	Bulk generate alt text from a CSV file with image URLs and optional metadata.
scrape_page	Scan a web page, find images missing alt text, and queue generation. Results are async -- use list_images to check progress.

How to install the Alttext-mcp Server

{
  "mcpServers": {
    "alttext-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@alttext_ai/alttext-mcp"
      ],
      "env": {
        "ALTTEXT_API_KEY": "YOUR_ALTTEXT_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.