Alttext MCP

Name: Alttext MCP
Author: alttextai

by alttextaiversion 1.0.5i★ –iRuns on your computer

Registry nameio.github.alttextai/alttext-mcp

Install

Overview

Description from the maker (original English)

Generate alt text, translate descriptions, and manage your AltText.ai image library.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Design, images & audio
You need to fill in: ALTTEXT_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: ALTTEXT_API_KEY, ALTTEXT_API_BASE_URL

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

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

Run this in your terminal

claude mcp add alttext --env ALTTEXT_API_KEY=your-value --env ALTTEXT_API_BASE_URL=your-value -- npx -y @alttext_ai/alttext-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "alttext": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alttext_ai/alttext-mcp"
      ],
      "env": {
        "ALTTEXT_API_KEY": "your-value",
        "ALTTEXT_API_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

ALTTEXT_API_KEY secret required env
Your AltText.ai API key
ALTTEXT_API_BASE_URL env
Optional API base URL override for proxies or alternate endpoints

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account alttextai, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Design, images & audioi

More stars than 0% of the other 2204 servers in this category
Published to the registry more recently than 34% of the other 2204 servers in this category
Basic checks equal to or better than 100% of the other 2204 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Alttext MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: ALTTEXT_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.5) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Figma Context MCP, Claude Real Video, Figma MCP Server

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Figma Context MCP

by GLips

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

Runs on your computer★ 16,165MITUpdated 5 months ago

Install

Claude Real Video

by HUANGCHIHHUNGLeo

Let any LLM watch a video locally — and search everything it has ever watched.

Runs on your computer★ 2,284MITUpdated 2 months ago

Install

Figma MCP Server

by figma

Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.

Runs in the cloud★ 2,152Updated 13 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

AltText.ai 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.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Verify this package

This server runs npx -y @alttext_ai/alttext-mcp, which downloads and executes code with your API key in its environment. That's worth a moment of verification before you install — by you or by an AI agent doing the setup. Everything below should match:

Signal	Value
npm package	`@alttext_ai/alttext-mcp`
Source repository	`github.com/alttextai/alttext-mcp`
Publisher	AltText.ai
Provenance	Published from this repo's CI with npm provenance — npm shows a verified build badge linking the package to this exact commit

The npm scope is `@alttext_ai` (with an underscore), while the GitHub org is `alttextai` (no underscore). This is intentional, not a typosquat: the @alttextai npm scope was already taken, so we publish under @alttext_ai. The two names refer to the same official AltText.ai package.

To cryptographically verify the published package was built by this repo's CI — not just trust the metadata — run:

npm audit signatures

from a project where the package is installed. This validates the registry signature and the npm provenance attestation, which links the tarball to a specific commit and GitHub Actions build. A counterfeit package can forge repository.url and other metadata, but it cannot forge the provenance attestation — so this is the check that actually matters.

(For a quick, weaker cross-reference of the *claimed* source you can run npm view @alttext_ai/alttext-mcp repository.url, but note that field is publisher-controlled metadata and proves nothing on its own.)

Pinning a version

The setup snippet uses npx -y @alttext_ai/alttext-mcp, which always resolves to the latest published version and re-runs it on every launch. That keeps you current, but it also means a future release runs automatically without review. If you want a reproducible, audited install, pin a specific version:

"args": ["-y", "@alttext_ai/alttext-mcp@1.0.5"]

Run npm audit signatures against the pinned version, and bump it deliberately when you're ready to take a new release.

Setup

Requirements: Node.js 22+ and an AltText.ai API key

Add the server to your MCP client configuration:

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

Where to add this:

Client	Config file
Claude Desktop	`claude_desktop_config.json`
Claude Code	`.mcp.json` in your project root
Cursor	MCP settings in the Cursor preferences
Windsurf	MCP settings in the Windsurf preferences

Command-line tool

The same operations are available as the alttext command, which also manages an account's site API keys with a full-access key. See packages/cli/README.md for commands, flags and exit codes.

Once @alttext_ai/cli is released on npm:

npm install -g @alttext_ai/cli

alttext login alttext whoami

Until then, build it from a clone of this repo:

npm install

npm run build npm link --workspace packages/cli

Agent skill

skills/alttext teaches Claude Code, Codex and other coding agents to drive the alttext CLI: checking whoami first, parsing --json, dry-running and asking before a rotate, revoke or delete, keeping tokens out of the conversation, and the reseller workflows for onboarding, billing and leaked keys. The skill contains no credentials, and it tells the agent to have you run alttext login yourself rather than paste a key into chat. It needs the CLI installed.

With npx skills, for any supported agent:

npx skills add alttextai/alttext-mcp --skill alttext

As a Claude Code plugin, from this repo's plugin marketplace:

claude plugin marketplace add alttextai/alttext-mcp

claude plugin install alttext@alttext-ai

Or in one step inside a Claude Code session (2.1.275 or later): /plugin install alttext --marketplace alttextai/alttext-mcp.

From a local clone, pass the clone's path instead: npx skills add ./alttext-mcp --skill alttext, or claude plugin marketplace add ./alttext-mcp.

Tools

Account Management

Tool	Description
`get_account`	Check your credit balance, usage, and account settings.
`update_account`	Update account name, webhook URL, or notification email.

Generate Alt Text

Tool	Description
`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.

Manage Image Library

Tool	Description
`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 Operations

Tool	Description
`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.

Effects and processing

This package uses stdio and runs on the machine launching the MCP client. Image and CSV paths refer to that machine; selected file contents are uploaded to AltText.ai.

Generation and translation use your account credits. Additional languages and image conversion can increase the total. Check get_account before paid work. Generation can overwrite existing alt text when requested; updates replace supplied fields and deletion removes the image from the library.

CSV imports and page scraping queue background processing. An accepted request does not mean generation has finished; inspect the image library and any configured completion notifications. Tool annotations describe effects for clients; they do not enforce confirmation.

Example Prompts

Once configured, just ask your AI assistant:

Account & Credits

"How many credits do I have left?"
"Update my webhook URL to https://example.com/webhook"

Generate Alt Text

"Generate alt text for https://example.com/photo.jpg"
"Generate alt text for this image" (with local file)
"Generate alt text in French and Spanish for this image"
"Translate image abc123 to German"

Manage Library

"Search my images for 'product photo'"
"List my images"
"Get details for image abc123"
"Update the alt text for asset abc123"
"Delete image xyz789"

Bulk Operations

"Generate alt text for images missing it on https://example.com"
"Process this CSV file of image URLs" (bulk_create)

Environment Variables

Variable	Required	Description
`ALTTEXT_API_KEY`	Yes	Your AltText.ai API key
`ALTTEXT_API_BASE_URL`	No	Override the API base URL (default: `https://alttext.ai/api/v1`)

Development

The repo is an npm workspace: packages/core (private API client, schemas and formatters, bundled into each published package), packages/mcp (@alttext_ai/alttext-mcp) and packages/cli (@alttext_ai/cli, the alttext command).

npm install

npm run check

The root package.json version is the only one to edit. npm run version:stamp copies it into every package and server.json, and CI fails when they drift. A v* tag matching that version publishes both packages.

Tests use mocked fetch calls -- no API key or network access needed.

npm run skills:validate checks each skill's frontmatter and links, and that every alttext command and flag a skill mentions exists in the built CLI. It runs as part of npm run check, after the build.

Hosted deployments must rate-limit POST /register at a trusted edge using the verified client address. The Node service deliberately ignores forwarded client-address headers because accepting them without an authenticated proxy boundary would let callers spoof the rate-limit identity.

The production container and required settings are documented in docs/deployment.md.

License

MIT

Registry publishing

server.json describes the stdio npm package. Its name matches mcpName in packages/mcp/package.json; both versions must match the release being submitted. Publish and verify that exact npm version before running mcp-publisher publish. Registry acceptance and directory approval are separate from an npm release.

Alttext MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Design, images & audioi

Common questions

Alternatives

Figma Context MCP

Claude Real Video

Figma MCP Server

README from the maker

AltText.ai MCP Server

Verify this package

Pinning a version

Setup

Command-line tool

Agent skill

Tools

Account Management

Generate Alt Text

Manage Image Library

Bulk Operations

Effects and processing

Example Prompts

Account & Credits

Generate Alt Text

Manage Library

Bulk Operations

Environment Variables

Development

License

Registry publishing