# AgentImgHost — LLM Discovery File
# https://llmstxt.org standard
# Last updated: 2025

> AgentImgHost is a developer-focused image hosting service built specifically for AI agents, bots, and automation workflows. Upload an image with a single curl command and receive a direct, permanent public CDN URL in return.

## What is AgentImgHost?

AgentImgHost provides a REST API and an MCP (Model Context Protocol) server that lets AI agents upload, manage, and delete images programmatically. It is designed to be agent-native: minimal surface area, fast responses, and direct public URLs — no web scraping, no indirect proxying.

**Homepage:** https://agent-img.com  
**API Base:** https://agent-img.com/api  
**MCP Server:** https://agent-img.com/mcp/  
**Documentation:** https://agent-img.com/docs  
**SKILL.md (agent instructions):** https://agent-img.com/skill.md

---

## Key Capabilities

- Upload images via `curl`, Python, Node.js, or any HTTP client
- Receive a permanent, direct public URL immediately after upload
- Delete images by ID
- List uploaded images with pagination
- Native MCP server with 4 tools: `upload_image`, `list_images`, `delete_image`, `get_account_info`
- Plan-aware enforcement (file size limits, image count limits, circular overwrite)
- Bearer token authentication (`Authorization: Bearer aih_...`)

---

## Quick Start (curl)

```bash
curl -X POST https://agent-img.com/api/upload \
  -H "Authorization: Bearer aih_your_token_here" \
  -F "file=@screenshot.png"
```

Response:
```json
{
  "url": "https://agent-img.com/a1b2c3/7f8e9a0b.png",
  "id": "7f8e9a0b1c2d3e4f",
  "size_bytes": 48291,
  "expires_at": null
}
```

The `url` field is a direct public link — embed it anywhere, share it, use it in markdown, HTML, or agent responses.

---

## MCP Server Integration

AgentImgHost exposes a Streamable HTTP MCP server at `https://agent-img.com/mcp/`.

### Add to Claude Desktop / Cursor / VS Code

```json
{
  "mcpServers": {
    "agentimghost": {
      "url": "https://agent-img.com/mcp/",
      "headers": {
        "Authorization": "Bearer aih_your_token_here"
      }
    }
  }
}
```

### Add via Claude Code CLI

```bash
claude mcp add --transport http agentimghost \
  https://agent-img.com/mcp/ \
  --header "Authorization: Bearer aih_your_token_here"
```

### Add via GitHub Copilot CLI

```bash
gh copilot mcp add agentimghost \
  --url https://agent-img.com/mcp/ \
  --header "Authorization=Bearer aih_your_token_here"
```

### Available MCP Tools

| Tool | Description |
|---|---|
| `upload_image` | Upload base64-encoded image, returns public URL |
| `list_images` | List uploaded images (paginated, up to 200) |
| `delete_image` | Delete an image by UUID |
| `get_account_info` | Return current plan, usage, and limits |

---

## Authentication

All requests require a Bearer token:

```
Authorization: Bearer aih_your_token_here
```

Get your token at https://agent-img.com/dashboard after registering for free.

---

## Plan Tiers

| Plan | Images | Max File Size | Price |
|---|---|---|---|
| Free | 100 | 1 MB | Free |
| Pro | 1,000 | 2 MB | $1/month |
| Business | 10,000 | 5 MB | $5/month |
| Custom | Unlimited | Custom | Contact us |

---

## API Endpoints

| Method | Path | Description |
|---|---|---|
| POST | /api/upload | Upload an image (multipart/form-data) |
| GET | /api/images | List images for authenticated user |
| DELETE | /api/images/{id} | Delete an image by ID |
| GET | /api/health | Health check |

---

## Supported Image Formats

JPEG · PNG · GIF · WebP · AVIF · SVG · BMP · TIFF

---

## Error Codes

| Status | Meaning |
|---|---|
| 401 | Invalid or missing API token |
| 413 | File too large for your plan |
| 415 | Unsupported file type |
| 429 | Image limit reached (circular overwrite disabled) |
| 500 | Server error — retry |

---

## Integrations

AgentImgHost's SKILL.md is compatible with:
- **Claude Code / Claude API** — reads SKILL.md via bash for agentic workflows
- **Cursor** — uses SKILL.md as an open standard for agent capabilities
- **GitHub Copilot / VS Code** — supports SKILL.md for customizing AI interactions
- **Mintlify** — generates SKILL.md for documentation sites
- **OpenClaw / ClawHub** — listed at https://clawhub.ai/

---

## Further Reading

- Full API docs: https://agent-img.com/docs
- Agent instructions (SKILL.md): https://agent-img.com/skill.md
- Register for free: https://agent-img.com/register