# OneSimpleAPI — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/onesimpleapi

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_onesimpleapi?ms=1787291220000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/onesimpleapi/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/onesimpleapi/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/onesimpleapi/skill.md
Postman collection (v2.1): https://mcp.ai/onesimpleapi/postman.json

## Tools
- onesimpleapi_analyze_readability(text: string) — Analyze text for readability, grade level, reading time, difficult-word counts, and sentiment.
- onesimpleapi_calculate_ppp_discount(price: number, max_discount?: number, destination_user_ip?: string, origin_country_code: string, destination_country_code?: string) — Calculate a purchasing-power-parity discount and localized price between an origin and a destination country.
- onesimpleapi_capture_screenshot(url?: string, html?: string, force?: boolean, screen?: string, full_page?: boolean, background?: boolean) — Capture a webpage URL or raw HTML as a hosted screenshot and return its URL and rendering metadata.
- onesimpleapi_convert_currency(from_value?: number, to_currency: string, from_currency?: string) — Convert an amount between supported currencies and return the converted value and exchange rate.
- onesimpleapi_create_short_url(url: string, end_date?: string, single_use?: boolean, start_date?: string, forward_params?: boolean, temporary_redirect?: boolean) — Create a OneSimpleAPI short URL with optional one-time-use, redirect, query-forwarding, and active-date controls.
- onesimpleapi_delete_file(url: string) — Delete a generated OneSimpleAPI file by its hosted URL and return the updated file record.
- onesimpleapi_expand_short_url(url: string) — Resolve a shortened URL and return its final URL, redirect count, and redirect trace.
- onesimpleapi_generate_or_convert_color(hue?: number, text?: string, color?: string, lightness?: number, saturation?: number) — Generate a deterministic color palette from text or convert a supplied color into HEX, RGB, HSL, and related palette values.
- onesimpleapi_generate_pdf(url?: string, html?: string, page?: string, force?: boolean, background?: boolean) — Generate a PDF from either a webpage URL or raw HTML and return the hosted PDF URL and page metadata.
- onesimpleapi_generate_qr_code(size?: string, color?: string, format?: string, message: string, background?: string) — Generate a hosted PNG or SVG QR code for a message and return its URL.
- onesimpleapi_get_image_information(raw?: boolean, url: string) — 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.
- onesimpleapi_list_files(status?: string, next_cursor?: string) — Return one page of generated files owned by the connected account, optionally filtered by live or deleted status.
- onesimpleapi_list_short_urls(next_cursor?: string) — Return one page of OneSimpleAPI short URLs and their click statistics.
- onesimpleapi_transform_image(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) — Resize, crop, rotate, flip, filter, border, optimize, and host an image, returning the generated image URL and metadata.
- onesimpleapi_validate_email(email: string) — Validate an email address and assess its domain, MX records, deliverability, disposability, role status, and registration safety.

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

## Links
Docs: https://mcp.ai/docs/mcps/onesimpleapi
Website: https://mcp.ai/mcps/onesimpleapi