AltText.ai MCP integration for AI agents.
Connect AI agents to AltText.ai through 7 structured actions, including get account, create image, delete image, and scrape page. Review authentication, inpu…
- ACTION CONTRACTS
- 7
- AUTHENTICATION
- API key
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the AltText.ai integration exposes
The AltText.ai Agent App exposes 7 provider-backed actions for ai and design & media work. Its current contract lets an authorized agent retrieve alttext.ai account settings and usage details for the api key, add a publicly accessible image url to alttext.ai and generate alt text, and delete an image from the alttext.ai library by asset id. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses API key. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected AltText.ai account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real AltText.ai capabilities.
Showing 7 of 7 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_accountREADRetrieve AltText.ai account settings and usage details for the API key.
create_imageWRITEAdd a publicly accessible image URL to AltText.ai and generate alt text.
INPUTS: url / asset_id / tags / metadata / ecomm
delete_imageHIGH IMPACTDelete an image from the AltText.ai library by asset ID.
INPUTS: asset_id
scrape_pageREVIEWScrape a web page or raw HTML document and queue discovered images for alt text generation.
INPUTS: url / html / keywords / negative_keywords / lang
get_imageREADRetrieve a single AltText.ai image record by asset ID.
INPUTS: asset_id
list_imagesREADList image records in the AltText.ai library with optional URL filtering.
INPUTS: page / limit / url
search_imagesREADSearch the AltText.ai image library by URL, asset ID, or alt text content.
INPUTS: query / page / limit
INPUT CONTRACTS
Know what the action needs before it runs.
create_image
urlREQUIRED- The public URL of the image that needs alt text.
asset_idOPTIONAL- Your own unique asset ID for this image.
tagsOPTIONAL- Words or phrases to associate with the image.
metadataOPTIONAL- Custom key-value metadata associated with the image.
ecommOPTIONAL- Ecommerce product context for product image alt text generation.
delete_image
asset_idOPTIONAL- The asset ID of the image to delete.
scrape_page
urlOPTIONAL- The page URL to scrape. The crawler does not execute JavaScript.
htmlOPTIONAL- Raw HTML document to parse for image elements.
keywordsOPTIONAL- Keywords or phrases to consider when generating SEO-optimized alt text.
negative_keywordsOPTIONAL- Keywords or phrases to consider when generating SEO-optimized alt text.
langOPTIONAL- Language code or comma-separated language codes for generated alt text.
get_image
asset_idOPTIONAL- The unique asset ID of the image to retrieve.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Get Account
Retrieve AltText.ai account settings and usage details for the API key. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
get_accountControl Create Image
Add a publicly accessible image URL to AltText.ai and generate alt text. Resolve the target first, present material changes for confirmation, and make retries idempotent where the provider supports it.
create_imageVerify with Get Image
Retrieve a single AltText.ai image record by asset ID. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
get_imageSAFETY BOUNDARY
Operate AltText.ai with explicit limits
- Authorize AltText.ai with API key and grant only the provider access required by the selected actions.
- 2 actions are change-capable by name. Confirm the target identity and material parameters before allowing a write.
- Treat `delete_image` as high-impact operations and require an explicit approval boundary.
- No provider scope string is declared on the sampled actions. Verify the connected account's actual permissions in AltText.ai rather than assuming unrestricted access.
- After a call, inspect the structured result and execution record before reporting that the AltText.ai task completed successfully.
CONNECTION MODEL
API key
AltText.ai API key sent with the X-API-Key header. Create or view API keys in your AltText.ai account: https://alttext.ai/account/api_keys.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 4
- WRITE SIGNALS
- 1
- HIGH IMPACT
- 1
- REVIEW SIGNALS
- 1
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by AltText.ai.