Hosted, No Install
Add one URL to your assistant, sign in to AltText.ai, and approve access. There's nothing to install and no API key to copy.
Step 1: Add AltText.ai to your assistant
Claude
Works in Claude on the web and desktop. Confirm the connector Claude fills in, then sign in.
Or open Customize, then Connectors, choose Add custom connector, and paste the URL. On Team and Enterprise plans, an owner adds the connector first.
ChatGPT
- In Settings, open Security and login and turn on Developer mode.
- Go to chatgpt.com/plugins and click +.
- Name it AltText.ai and paste this URL:
https://mcp.alttext.ai/mcp
Needs Plus, Pro, Business, Enterprise, or Edu on the web. On Business, Enterprise, and Edu, an admin has to allow Developer mode first.
Claude Code
claude mcp add --transport http alttext-ai https://mcp.alttext.ai/mcp
Then run /mcp in Claude Code to sign in.
Codex
codex mcp add alttext-ai --url https://mcp.alttext.ai/mcp
Codex opens your browser to sign in. If it doesn't, run codex mcp login alttext-ai.
Cursor
Confirm the install in Cursor, then sign in when it asks.
Visual Studio Code
Confirm the install in VS Code, then sign in when it asks.
Any other MCP client
Add this URL as a remote MCP server, then sign in when your client asks.
https://mcp.alttext.ai/mcp
-
Step 2
Sign in and approve
Your assistant opens an AltText.ai sign-in page. After you sign in, you'll see the name the assistant gave itself (marked unverified), the account it wants to connect to, and whether it asked for read-only or read-and-write access.
Choose Allow connection if you started the request. The connection lasts 90 days, and you can revoke it sooner.
-
Step 3
Start asking
Ask for alt text in plain language. Your assistant picks the right AltText.ai tool. Generating and translating alt text uses your account credits, the same as any other AltText.ai request.
Things to ask with read access
Works on any connection.
- "How many credits do I have left?"
- "Show me the last 20 images I processed."
- "Find images whose alt text mentions sofas."
- "What's the alt text on the image with asset ID hero-banner?"
Things to ask with read-and-write access
Needs a connection approved with read-and-write access.
- "Write alt text for https://example.com/photo.jpg."
- "Add Spanish and French alt text to that image."
- "Scan https://example.com/blog and generate alt text for images that are missing it."
- "Shorten the alt text on hero-banner to under 100 characters."
- "Delete the image with asset ID old-logo."
- "Set my notification email to team@example.com."
To see or revoke access, sign in and open API Keys, then choose Manage assistant connections.
Hosted tools (12 local)
To connect
Languages
2.1 AA Compliant
Tools Your AI Assistant Can Use
The hosted server includes 10 tools for image accessibility. Your assistant picks the right one based on what you ask. The local install adds two that read files from your machine: generate_alt_text_from_file and bulk_create for CSV files.
Generate Alt Text
From image URLs, with a Final Pass prompt, keywords, character limits, and multilingual output. The local install also reads image files.
Manage Library
Search, list, update, and delete images. Your AI assistant can browse your entire image library by asset ID or alt text content.
Scan Web Pages
Point your AI assistant at any URL. It finds images missing alt text and queues generation automatically.
Translate to 130+ Languages
Generate alt text in multiple languages at once, or add translations to existing images later.
Developer Option: Install Locally with npx
Prefer running the server on your own machine, or need the file and CSV tools? Paste a single prompt into your AI coding assistant. It reads the setup instructions, adds the MCP server config, and you're ready to go.
The local server runs on your machine. Your API key stays in your local config. Images are sent directly to AltText.ai's API.
Copy one prompt
A single line that tells your AI assistant where to find the local setup instructions.
AI self-configures
Your assistant reads the instructions, adds the server to your MCP config, and verifies everything works. It asks before making changes.
Start generating
Ask for alt text on any image URL, local file, or entire web page. Results come back in seconds.
Install Locally with Your AI Assistant
Paste this prompt into your AI coding assistant. It installs the open-source server with npx and asks before changing your config.
Works with Claude Code, Cursor, and Windsurf — paste and run:
Follow the LOCAL INSTALL section of https://alttext.ai/agent-setup to install the AltText.ai MCP server with npx and configure yourself for image alt text generation. Ask me before making config changes.
What People Are Building
Accessibility Audits
Point your AI assistant at a staging URL before launch. It scans every image, identifies missing alt text, and generates descriptions — turning a manual audit into a one-line command.
Used by: Web agencies, development teams, QA engineers
CMS Content Workflows
Generate alt text as you build content. Hand your assistant an image URL, or a file from your project with the local install, and paste the description into your CMS. Natural language, not keyword tags.
Used by: Content managers, marketing teams, bloggers
E-commerce Product Images
Process product catalogs via CSV bulk import with the local install. Your AI assistant reads the CSV, submits it, and reports back on results. Thousands of images, zero manual work.
Used by: Online retailers, marketplace sellers, product teams
Multilingual Websites
Generate alt text in multiple languages simultaneously. Ask for French, Spanish, and German in one request. Each translation costs one credit and reads naturally in the target language.
Used by: International brands, translation teams, global publishers
MCP Server vs. Direct API Integration
Building Your Own API Integration
- Write HTTP client code, handle authentication, parse responses
- Build error handling, retry logic, and rate limiting
- Maintain integration as API evolves
- Every developer on the team needs API documentation
AltText.ai MCP Server
- Hosted connector — paste one URL, sign in, done
- Built-in error handling, connection management, and retries
- Hosted server is always current; the npx install updates itself
- Natural language interface — just ask for what you need
Simple, Transparent Pricing
Annual plans include rollover credits. Pick the tier that matches your image volume.
Bronze
Perfect for personal blogs and portfolios
$49/year
1,200 credits (4¢ per image)
View Bronze planSilver
Growing websites and small businesses
$189/year
6,000 credits (3¢ per image)
View Silver planGold
E-commerce stores and content teams
$489/year
24,000 credits (2¢ per image)
View Gold planPlatinum
Enterprise publishers and platforms
$2199/year
120,000 credits (<2¢ per image)
View Platinum planNeed more? Contact us for enterprise pricing.
AI Assistant Integration FAQs
FAQ
-
MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools. The AltText.ai MCP server gives your AI assistant tools for generating alt text, managing images, and scanning web pages for missing alt text.
-
The hosted server runs at https://mcp.alttext.ai/mcp. You add it by URL, sign in to AltText.ai, and approve access. There's nothing to install and no API key to copy. The local install runs the open-source package on your machine with npx and your API key, and adds two tools that work with your files: generate_alt_text_from_file and bulk_create for CSV files.
-
The hosted server works in Claude, ChatGPT (with Developer mode on), Claude Code, Codex, Cursor, VS Code, and other tools that support remote MCP servers. The local install works with MCP clients that run local servers. We provide one-prompt setup for Claude Code, Cursor, and Windsurf.
-
About a minute either way. Hosted: add https://mcp.alttext.ai/mcp as a connector, then sign in and approve. Local: paste a single prompt into your coding assistant. It reads our setup page and adds the server config, and it asks before changing anything.
-
The hosted server and the open-source local server are both free to use. You need an AltText.ai account — every new account includes 25 free images. After that, credits start at $4.99 for 250 images.
-
Over 130 languages. You can generate alt text in multiple languages simultaneously, or translate existing alt text to new languages later. Each language generation costs one credit.
-
With the hosted server, you sign in to AltText.ai and approve each connection yourself. Your assistant never gets your API key, connections expire after 90 days, and you can revoke one any time. With the local install, the server runs on your machine and your API key stays in your local config. Either way, images are sent to AltText.ai's API over HTTPS.
-
Sign in to AltText.ai, open API Keys, and choose Manage assistant connections. It lists each connected assistant, its access level, and when it expires, with a button to revoke it.
-
Yes. Both versions include scrape_page, which scans a web page and queues alt text for images that are missing it. The local install also includes bulk_create for CSV files.
-
You don't need to. The hosted server is always current. The local install runs through npx, so it fetches the latest version each time unless you pin one.
Nothing found.
If you can't find what you're looking for, please contact our customer support team.
Related Solutions
Already using a CMS or platform? We have native integrations for these too:
WordPress Plugin
Automatic alt text on upload for your WordPress media library.
Shopify App
Bulk process all product images in your Shopify store.
Custom API Integration
Build your own integration with our REST API.
Accessibility Compliance
Learn how AI-generated alt text helps meet WCAG 2.1 and ADA requirements.
Your AI Assistant Is Missing a Superpower
One URL. No install. Every image on your site gets accessible, SEO-optimized alt text, right from your assistant.
Free to try. No credit card required.