# mapleflow

Unified AI API — 30+ models from OpenAI, Anthropic, Google, Groq, and xAI through one API key. Plus translation, weather, and utility APIs.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add contact-wwl4/mapleflow

# Browse available tools
npx -y @smithery/cli@latest tool list contact-wwl4/mapleflow

# Get full schema for a tool
npx -y @smithery/cli@latest tool get contact-wwl4/mapleflow ai_chat

# Call a tool
npx -y @smithery/cli@latest tool call contact-wwl4/mapleflow ai_chat '{}'
```

## Direct MCP Connection

Endpoint: `https://mapleflow.run.tools`

**Required config:**
- `apiKey` (header) — Your MapleFlow API key. Get one free at mapleflow.io

## Tools (8)

- `ai_chat` — Send a message to any of 30+ AI models (OpenAI, Anthropic, Google, Groq, xAI). Returns the model's response. Supports c…
- `translate` — Translate text between 75+ languages with auto-detection. Supports dynamic pricing based on text length.
- `weather` — Get current weather for any city or coordinates worldwide. Returns temperature, humidity, wind, and conditions.
- `currency` — Get live currency exchange rates and convert between 160+ currencies.
- `ai_images` — Generate images from text prompts using Flux models. Returns base64-encoded PNG.
- `ai_speech` — Convert text to natural-sounding speech audio. Returns base64-encoded WAV.
- `ai_transcribe` — Transcribe audio to text with timestamps using Whisper.
- `ai_embeddings` — Generate vector embeddings for text search and similarity comparison.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get contact-wwl4/mapleflow <tool-name>
```