AADDYY
FOR DEVELOPERS

Build with 100+ AI tools.

MCP server, REST API, or NPM SDK. One API key, pay-per-use from $0.01. 50 free credits on signup — no card required.

Get API Key →Read the Docs →
Schema
LLMs
Open Markdown contentOpen in ChatGPTOpen in Claude

MCP Server

For AI agents. Use AADDYY tools directly from Cursor, Claude Code, Windsurf, or any MCP client. The agent calls tools automatically.

bash
npx @aaddyy/mcp-server
See setup guide ↓

REST API

For developers. Simple HTTP requests with your API key. Works with any language, any framework.

header
Authorization: Bearer aip_…
View all endpoints →

NPM SDK

For builders. Type-safe client with automatic V2 polling. Works in Node.js, Bun, Deno, and edge runtimes.

bash
npm install aaddyy
View on NPM →

Quick Start

  1. 1

    Get 50 free credits

    Sign up — no card required. Credits never expire.

  2. 2

    Create an API key

    Keys start with aip_

    Create API Key
  3. 3

    Make your first call

    cURL
    curl -X POST https://backend.aaddyy.com/api/ai/article \
 -H "Authorization: Bearer aip_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '{"topic": "AI tools for developers", "tone": "professional"}'

MCP Server Setup

Add one config file to your editor. Your AI agent will discover all AADDYY tools automatically.

Cursor

.cursor/mcp.json

json
{
 "mcpServers": {
 "aaddyy": {
 "command": "npx",
 "args": ["@aaddyy/mcp-server"],
 "env": {
 "AADDYY_API_KEY": "aip_your_key_here"
 }
 }
 }
}

Claude Code

~/.claude/claude_desktop_config.json

json
{
 "mcpServers": {
 "aaddyy": {
 "command": "npx",
 "args": ["@aaddyy/mcp-server"],
 "env": {
 "AADDYY_API_KEY": "aip_your_key_here"
 }
 }
 }
}

Windsurf

.windsurf/mcp.json

json
{
 "mcpServers": {
 "aaddyy": {
 "command": "npx",
 "args": ["@aaddyy/mcp-server"],
 "env": {
 "AADDYY_API_KEY": "aip_your_key_here"
 }
 }
 }
}

Step 3 — Use it naturally

Just ask your agent. It picks the right tool automatically:

  • "Generate an article about AI trends in 2026"
  • "Create a logo for my startup NovaTech"
  • "Solve this integral: ∫x² from 0 to 5"
  • "Analyze the SEO of example.com"
  • "Generate a QR code for my website"

NPM SDK

Type-safe. Handles V2 async polling automatically. Works in any Node.js/Bun/Deno environment.

javascript
import { AADDYY } from 'aaddyy'

const client = new AADDYY() // reads AADDYY_API_KEY from env

// Text tools
const article = await client.articles.generate({ topic: 'AI trends 2026' })
const essay = await client.essays.write({ topic: 'Climate change', length: 800 })

// Image tools
const image = await client.images.generate({ prompt: 'sunset over mountains' })
const qr = await client.qrCode.generate({ content: 'https://aaddyy.com' })

// V2 async tools (video, image editing) — SDK handles polling automatically
const video = await client.videos.generate({ prompt: 'A timelapse of a city' })

Pricing

1 credit
= $0.01
Free credits
50 on signup — no card, no expiry
Text tools
1–5 credits per call ($0.01–$0.05)
Image / video
4–20 credits per call ($0.04–$0.20)
Free tools
Image compressor, PDF merge, Image to PDF

Authentication

Authorization: Bearer aip_YOUR_KEY
  • Keys start with aip_
  • Email verification required
  • Google/Auth0 users auto-verified

Rate Limits

Per minute
60 requests
Per hour
1,000 requests
Per day
10,000 requests

Headers: X-RateLimit-Remaining, X-RateLimit-Reset

Async Tools (V2)

Video, image editing, and long-running tools use async processing. The SDK and MCP server handle polling automatically.

  1. 1. Submit
    POST /api/v2/ai/{tool-name} → { jobId, pollUrl }
  2. 2. Poll
    GET /api/v2/ai/jobs/{jobId} → { status: "completed", result: {...} }