# All Images AI — how to use (mcp.ai)

Connect your All Images AI account and use 7 tools for artificial intelligence straight from your AI agent. Connect with your own API key. All-Images.ai provides AI-powered image generation, retrieval, and management services, enabling developers to create and manage images through advanced AI capabilities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_all_images_ai?ms=1787293620000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `all_images_ai_check_api_key`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/all_images_ai`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/all_images_ai/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/all_images_ai/check/api/key` — Validates the current API key and retrieves associated account information. Returns the email address and optional name associated with the API key. Use this action to verify your API key is valid bef
- `POST https://api.mcp.ai/api/all_images_ai/create/webhook/endpoint` — Tool to add a webhook endpoint to an API key. Use when you want to receive print event callbacks at a custom endpoint.
  - body: { url: string, events?: string[] }
- `POST https://api.mcp.ai/api/all_images_ai/delete/image/generations` — Tool to delete one or more image generation batches by their print IDs. Use when you need to remove image generations that are no longer needed.
  - body: { printIds: string[] }
- `POST https://api.mcp.ai/api/all_images_ai/get/credits` — Tool to retrieve the current credits balance for your API key. Use this action to check available credits before making API calls that consume credits.
- `POST https://api.mcp.ai/api/all_images_ai/get/webhook` — Tool to retrieve webhook details by its ID. Use when you need to check the configuration of an existing webhook endpoint, including its URL and subscribed events.
  - body: { api_key_webhook_id: string }
- `POST https://api.mcp.ai/api/all_images_ai/list/automated/images` — Tool to list all images generated automatically for bulk use. Use after creating automated-image batches to review and manage them.
  - body: { tag?: string, name?: string, sort?: string, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/all_images_ai/list/downloaded/images` — Tool to list images that have been downloaded from All-Images.ai. Use this action to retrieve and filter downloaded images with optional date range filtering and pagination support.
  - body: { sort?: string, limit?: integer, offset?: integer, afterCreatedAt?: string, beforeCreatedAt?: string }

## Example prompts
- "What can I do in All Images AI?"
- "Show me a summary of my All Images AI account"

## More
- Page: https://mcp.ai/all_images_ai
- Agent spec (llms.txt): https://mcp.ai/all_images_ai/llms.txt
- Postman collection: https://mcp.ai/all_images_ai/postman.json