AltText.ai
AltText.ai is a service that automatically generates alt text for images, enhancing accessibility and SEO.
Verdict
Common use cases
- Generate alt text for blog images
- Audit accessibility of existing image libraries
- Batch-describe product photos before launch
- Search images by alt text keywords
- Update webhook settings for automation
Integration
- Vendor
- AltText.ai
- Category
- other
- Auth
- API_KEY
- Tools
- 5
- Composio slug
alttext_ai
Tools
- 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.
- 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.
- 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.
- Search Images
Tool to search for images and their alt text. use after specifying search keywords to retrieve matching images.
- Update Account
Tool to update account settings (e.g., webhook url, name). use after confirming current account details to modify settings.
Setup
Setup guide
- 1In Switchy, open your workspace settings and navigate to the MCP integrations panel. Click 'Add Integration' and select AltText.ai from the list. You'll be prompted to paste an API key — generate one by logging into your AltText.ai dashboard and visiting the API section under account settings. Copy the key and paste it into Switchy, then click 'Connect'. Switchy will verify the key by fetching your account details. Once connected, open any Space and type '@AltText.ai' to confirm the integration appears in the mention menu. Test it by asking '@AltText.ai check my account usage' — you should see your current plan limits and remaining credits. To generate alt text, provide an image URL in your prompt and ask the MCP to describe it.
What teammates see: by default, memories from AltText.ai are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check Account Usage
@AltText.ai show me my current account usage and limitsOpen in a Space →
Describe Single Image
@AltText.ai generate alt text for this image: [paste image URL here]Open in a Space →
Browse Image Library
@AltText.ai list the first 20 images in my library with their alt textOpen in a Space →
Search by Keyword
@AltText.ai search my images for alt text containing 'product demo' or 'dashboard'Open in a Space →
Update Webhook URL
@AltText.ai update my webhook URL to https://example.com/alttext-webhookOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@AltText.ai search for images tagged 'product launch' and show me what alt text we've used for those visuals
Found 12 images matching 'product launch'. Here's a sample: Image #4782 has alt text 'Three team members presenting a software dashboard on a large monitor in a modern conference room'; Image #4801 uses 'Close-up of a mobile app interface showing the new onboarding flow with purple gradient background'; Image #4819 describes 'Overhead view of marketing materials spread on a wooden table including brochures, business cards, and a tablet displaying the product homepage.' All images were processed between March 15-22, 2024.
This example shows the search capability for finding previously generated alt text. Useful when auditing existing image descriptions or maintaining consistency across a content library. Requires images to have been processed through AltText.ai previously—won't generate new descriptions for unseen images.
@AltText.ai check my account usage limits before we process this batch of 200 screenshots from the design team
Your AltText.ai account (Plan: Professional) shows 3,847 images processed this month out of your 5,000 monthly limit. You have 1,153 requests remaining, which is sufficient for the 200-screenshot batch. Your account is configured with webhook notifications enabled to https://yourteam.com/api/alttext-callback. Average processing time for recent batches has been 2-3 seconds per image.
Demonstrates the account information retrieval tool, which is essential before bulk operations to avoid hitting rate limits mid-process. The actual usage numbers and plan details will reflect your specific account state. Check this before large batches to prevent workflow interruptions.
@AltText.ai pull the last 50 images from our library and draft a style guide based on how we've been writing alt text for UI screenshots versus photos
Analyzed 50 recent images (32 UI screenshots, 18 photos). Pattern identified: UI screenshots use technical, action-oriented language ('Dashboard view showing three active projects with completion percentages and due dates'), while photos use descriptive, scene-setting language ('Smiling customer service representative wearing headset in a bright office environment'). UI descriptions average 12-15 words and focus on information hierarchy; photo descriptions average 10-13 words and emphasize human elements. Recommendation: Maintain this distinction—it serves accessibility by matching description style to content type.
This synthesis example combines the image retrieval tool with AI analysis to extract patterns from your alt text history. Particularly valuable for teams establishing accessibility guidelines or onboarding new content creators. The AI identifies trends the MCP data reveals, but style recommendations should be validated against WCAG standards.
Use-case deep-dives
When AltText.ai makes sense for one-time cleanup
A 3-person marketing team inherits a Webflow site with 400 images and zero alt text. They need to pass a WCAG audit before a Series A close. AltText.ai is the right call here: batch-upload the images, generate alt text in one session, then export and paste into the CMS. The Get Images tool lets you paginate through the library to verify coverage. The catch: this MCP doesn't write directly to your CMS, so you're still copy-pasting. If you're doing this monthly or need alt text inline with your publishing workflow, you want a Contentful or Sanity integration instead. For a one-time audit sprint, AltText.ai closes the gap fast.
Where AltText.ai falls short for ongoing SKU updates
A 6-person e-commerce team adds 50 new SKUs every week to Shopify. They want AI-generated alt text as part of the upload flow. AltText.ai isn't the move: you'd need to export images, send them to AltText.ai, retrieve the results with Get Images, then manually sync back to Shopify. The Search Images tool helps you find specific products after the fact, but there's no webhook or direct write-back to your store. If your catalog is static and you're doing a one-time backfill, fine. If you're publishing weekly, you need a Shopify app or a custom script that writes alt text at upload time. AltText.ai is a library tool, not a pipeline tool.
When AltText.ai works for small content teams
A 2-person nonprofit publishes 8 blog posts a month on WordPress, each with 3-5 images. They need alt text for compliance but don't have a designer. AltText.ai fits: upload the week's images on Monday, generate alt text in batch, then paste into WordPress before publish. The Get Account tool shows your usage limits so you don't hit the API ceiling mid-month. The workflow is manual but predictable. The threshold: if you're publishing daily or managing multiple sites, the copy-paste overhead compounds fast. At 8 posts a month, it's 15 minutes of admin work. At 40 posts, you're spending an hour a week on data entry. For low-frequency publishing, AltText.ai keeps you compliant without a dev lift.
Frequently asked
What does the AltText.ai MCP do in Switchy?
It generates alt text for images and manages your AltText.ai library directly from Switchy's AI workspace. Your team can retrieve account usage limits, search previously processed images, and update account settings without switching to the AltText.ai dashboard. The MCP handles authentication via API key and exposes five tools for image metadata operations.
Do I need a paid AltText.ai account to use this MCP?
Yes. The MCP requires an AltText.ai API key, which means you need an active AltText.ai subscription. Free trial keys work during the trial period. The Get Account tool lets you check your current usage limits before generating alt text, so you'll know when you're approaching your plan's monthly quota.
Can this MCP generate new alt text for images I upload?
No. The available tools only retrieve and search existing images already processed by AltText.ai, plus manage account settings. To generate new alt text, you still need to use AltText.ai's main API or web interface directly. This MCP is for querying your library and checking account status, not for processing new images.
Why use this MCP instead of the AltText.ai dashboard?
Speed and context. If your team is already working in Switchy, the MCP lets you search your alt text library or check usage limits without opening another tab. It's faster for bulk searches across your image metadata. For one-off image uploads or detailed account management, the dashboard is still more practical.
Who on the team should connect the AltText.ai API key?
Whoever owns your AltText.ai subscription. The API key grants full account access, including the ability to update settings and view all processed images. If multiple people need to query the library, share the connection in Switchy rather than distributing the API key. Usage counts against your AltText.ai plan, not Switchy's limits.