otherapi_key

AltText.ai

AltText.ai is a service that automatically generates alt text for images, enhancing accessibility and SEO.

Verdict

AltText.ai generates descriptive alt text for images using AI, making content accessible to screen reader users and improving SEO. When you @mention it in a Space, your team can describe images in documents, audit existing alt text across a library, or batch-process uploads before publishing. Content editors and accessibility leads get the most value — it removes the guesswork from writing descriptions. The MCP requires an API key and works best when you already have images hosted or referenced by URL. It won't analyze images stored only on your local machine.

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

  1. 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

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

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 text
Open 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-webhook
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@AltText.ai search for images tagged 'product launch' and show me what alt text we've used for those visuals

Output

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.

Notes

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.

Prompt

@AltText.ai check my account usage limits before we process this batch of 200 screenshots from the design team

Output

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.

Notes

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.

Prompt

@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

Output

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.

Notes

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

Marketing site accessibility audit

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.

E-commerce product catalog refresh

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.

Nonprofit blog accessibility compliance

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.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.