AADDYY
FOR DEVELOPERS

Build with 55 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 and verify your email — 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', wordCount: 800 })

// Image tools
const image = await client.images.generate({ prompt: 'sunset over mountains' })

// Async (V2) tools: the SDK submits the job and polls it until the result is ready
const prompt = await client.images.createPrompt({ imageUrl: 'https://example.com/photo.jpg' })

Pricing

1 credit
= $0.01
Free credits
50 on signup — no card, no expiry
Starting prices
1–250 credits per call ($0.01–$2.50), set per tool. See prices by tool group →
Free tools
QR Code Generator, Compress Image, JPG to PDF, Merge PDF

Authentication

Authorization: Bearer aip_YOUR_KEY
  • Keys start with aip_
  • Before you verify your email, you can create one key, with lower limits and an expiry date, and spend part of your free credits
  • Verify your email to unlock all your free credits and full key limits
  • Google/Auth0 users auto-verified

Rate Limits

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

Per key, once your email is verified. Until then, your key has lower limits. A key over its limit gets a 401 error: “Rate limit exceeded”.

Each IP address also has a limit per 15 minutes; past it, the API answers 429. Its headers: RateLimit-Limit, RateLimit-Remaining, 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: {...} }