# OneSimpleAPI — how to use (mcp.ai)

Connect your OneSimpleAPI account and use 15 tools for developer tools straight from your AI agent. Connect with your own API key. OneSimpleAPI provides utility APIs for web content, images, PDFs, QR codes, URL management, validation, exchange rates, and file management.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_onesimpleapi?ms=1787291160000`
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. `onesimpleapi_analyze_readability`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/onesimpleapi`
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/onesimpleapi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/onesimpleapi/analyze/readability` — Analyze text for readability, grade level, reading time, difficult-word counts, and sentiment.
  - body: { text: string }
- `POST https://api.mcp.ai/api/onesimpleapi/calculate/ppp/discount` — Calculate a purchasing-power-parity discount and localized price between an origin and a destination country.
  - body: { price: number, max_discount?: number, destination_user_ip?: string, origin_country_code: string, destination_country_code?: string }
- `POST https://api.mcp.ai/api/onesimpleapi/capture/screenshot` — Capture a webpage URL or raw HTML as a hosted screenshot and return its URL and rendering metadata.
  - body: { url?: string, html?: string, force?: boolean, screen?: string, full_page?: boolean, background?: boolean }
- `POST https://api.mcp.ai/api/onesimpleapi/convert/currency` — Convert an amount between supported currencies and return the converted value and exchange rate.
  - body: { from_value?: number, to_currency: string, from_currency?: string }
- `POST https://api.mcp.ai/api/onesimpleapi/create/short/url` — Create a OneSimpleAPI short URL with optional one-time-use, redirect, query-forwarding, and active-date controls.
  - body: { url: string, end_date?: string, single_use?: boolean, start_date?: string, forward_params?: boolean, temporary_redirect?: boolean }
- `POST https://api.mcp.ai/api/onesimpleapi/delete/file` — Delete a generated OneSimpleAPI file by its hosted URL and return the updated file record.
  - body: { url: string }
- `POST https://api.mcp.ai/api/onesimpleapi/expand/short/url` — Resolve a shortened URL and return its final URL, redirect count, and redirect trace.
  - body: { url: string }
- `POST https://api.mcp.ai/api/onesimpleapi/generate/or/convert/color` — Generate a deterministic color palette from text or convert a supplied color into HEX, RGB, HSL, and related palette values.
  - body: { hue?: number, text?: string, color?: string, lightness?: number, saturation?: number }
- `POST https://api.mcp.ai/api/onesimpleapi/generate/pdf` — Generate a PDF from either a webpage URL or raw HTML and return the hosted PDF URL and page metadata.
  - body: { url?: string, html?: string, page?: string, force?: boolean, background?: boolean }
- `POST https://api.mcp.ai/api/onesimpleapi/generate/qr/code` — Generate a hosted PNG or SVG QR code for a message and return its URL.
  - body: { size?: string, color?: string, format?: string, message: string, background?: string }
- `POST https://api.mcp.ai/api/onesimpleapi/get/image/information` — Extract dimensions, image metadata, EXIF camera fields, and available GPS details from an image URL. Returned fields vary with the metadata embedded in the image.
  - body: { raw?: boolean, url: string }
- `POST https://api.mcp.ai/api/onesimpleapi/list/files` — Return one page of generated files owned by the connected account, optionally filtered by live or deleted status.
  - body: { status?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/onesimpleapi/list/short/urls` — Return one page of OneSimpleAPI short URLs and their click statistics.
  - body: { next_cursor?: string }
- `POST https://api.mcp.ai/api/onesimpleapi/transform/image` — Resize, crop, rotate, flip, filter, border, optimize, and host an image, returning the generated image URL and metadata.
  - body: { crop?: string, flip?: string, page?: integer, size?: string, force?: boolean, image: string, border?: integer, crop_x?: number, crop_y?: number, format?: string, rotate?: string, filters?: string, optimize?: boolean, crop_mode?: string, resize_mode?: string, border_color?: string, border_method?: string }
- `POST https://api.mcp.ai/api/onesimpleapi/validate/email` — Validate an email address and assess its domain, MX records, deliverability, disposability, role status, and registration safety.
  - body: { email: string }

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

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