# Finalyy ⚡ — Free AI Models via MCP

**No API keys. No subscriptions. Just point your IDE and go.**

Finalyy converts free browser-based AI trials (ChatGPT, Claude, Gemini, DeepSeek, Flux, Kling, and more) into MCP tools and OpenAI-compatible endpoints. One CLI command, zero cost, production-grade quality.

```bash
npx finalyy init     # One-time setup
npx finalyy start    # Launch MCP server on localhost:1337
```

Then connect any MCP client — Cursor, Claude Desktop, Codex, Continue.dev, Cline, OpenClaw — and use frontier models for free.

---

## Why Finalyy

Every week, new AI providers launch free browser trials of frontier models. Developers can use them in a browser but **cannot integrate them into their tools, IDEs, or agents** because:

- Providers charge for API keys ($50–$500/mo)
- Browser sessions don't expose OpenAI-compatible endpoints
- No standard way to convert web trials → MCP tools
- Each provider has a different authentication mechanism

Finalyy solves this — one unified MCP server, community-driven provider registry, auto-fallback, zero API keys.

---

## Quick Start

### Prerequisites

- Node.js 18+
- A Chromium-based browser (Chrome, Edge, Brave)
- An active free account on any supported AI provider

### Install

```bash
npx finalyy init
```

This will:
1. Install the Finalyy CLI
2. Create `~/.finalyy/config.json`
3. Open a browser page to log into your AI providers
4. Capture and encrypt session cookies/tokens
5. Verify connectivity

### Start

```bash
npx finalyy start
```

MCP server starts at `http://localhost:1337`. Connect any MCP client.

### Connect

**Cursor:**
```json
// .cursor/mcp.json
{
  "mcpServers": {
    "finalyy": {
      "command": "npx",
      "args": ["finalyy", "start"]
    }
  }
}
```

**Claude Desktop:**
```json
// claude_desktop_config.json
{
  "mcpServers": {
    "finalyy": {
      "command": "npx",
      "args": ["finalyy", "start"]
    }
  }
}
```

**Claude Code:**
```bash
claude mcp add npx finalyy start
```

**Continue.dev / Cline / Codex:**
```json
// .vscode/mcp.json or config.json
{ "mcpServers": { "finalyy": { "command": "npx", "args": ["finalyy", "start"] }}}
```

### Verify

```bash
curl http://localhost:1337/v1/models
```

```json
{
  "models": [
    { "id": "chatgpt/gpt-4o", "provider": "chatgpt", "type": "chat", "status": "online" },
    { "id": "claude/sonnet-4", "provider": "claude", "type": "chat", "status": "online" },
    { "id": "gemini/pro-3.5", "provider": "gemini", "type": "chat", "status": "online" },
    { "id": "flux/pro", "provider": "flux", "type": "image", "status": "online" },
    { "id": "kling/1.6", "provider": "kling", "type": "video", "status": "online" }
  ]
}
```

---

## MCP Tools

| Tool | Description | Provider Examples | Model Types |
|------|-------------|-----------------|-------------|
| `chat` | Chat completion | ChatGPT, Claude, Gemini, DeepSeek | text, code, reasoning |
| `generate_image` | Image generation | Flux, DALL-E free, Stable Diffusion | text→image |
| `generate_video` | Video generation | Kling, Runway, Pika | text→video |
| `transcribe_audio` | Speech-to-text | Whisper, Deepgram free | audio→text |
| `analyze_image` | Vision analysis | Gemini Vision, Claude Vision | image+text→text |

Each tool maps to a specific provider's free tier through Finalyy's session adapter layer.

---

## Supported Providers

### Built-in (vetted, tested, maintained)

| Provider | Models | Type | Session Method | Status |
|----------|--------|------|----------------|--------|
| ChatGPT | GPT-4o, GPT-4.5 | chat | Cookie auth | ✅ Active |
| Claude | Sonnet 4, Opus 4.6 | chat, vision | Cookie auth | ✅ Active |
| Gemini | 3.5 Pro, 3.5 Flash | chat, vision | OAuth token | ✅ Active |
| DeepSeek | V3.2, R1 | chat, code | Cookie auth | ✅ Active |
| Flux | Pro 1.2, Dev | image | API key (free) | ✅ Active |
| Kling | 1.6 | video | Cookie auth | ✅ Active |

### Community (contributed, auto-tested)

100+ providers in community registry. See [Registry docs](REGISTRY.md) for adding new providers.

---

## Architecture Overview

```
┌──────────────────────────────────────────────────┐
│                  YOUR IDE / AGENT                 │
│  (Cursor · Claude Desktop · Codex · Continue)    │
└──────────────────────┬───────────────────────────┘
                       │ MCP Protocol (localhost:1337)
┌──────────────────────▼───────────────────────────┐
│                   FINALYY                         │
│                                                    │
│  ┌──────────┐  ┌──────────┐  ┌────────────────┐  │
│  │ CLI       │  │ MCP      │  │ Dashboard      │  │
│  │ (Init/Add │  │ Server   │  │ (Web UI)       │  │
│  │ /Start)   │  │ (Tools + │  │ Provider status│  │
│  │           │  │ Resources│  │ Usage + logs   │  │
│  └──────────┘  └────┬─────┘  └────────────────┘  │
│                     │                              │
│  ┌──────────────────▼──────────────────────────┐  │
│  │          Session Manager                     │  │
│  │  ┌────────┐ ┌────────┐ ┌────────┐ ┌──────┐ │  │
│  │  │ChatGPT │ │ Claude │ │ Gemini │ │ ...  │ │  │
│  │  │Session │ │Session │ │Session │ │      │ │  │
│  │  └────────┘ └────────┘ └────────┘ └──────┘ │  │
│  │  Cookie Rotator · Health Checker · Captcha  │  │
│  └──────────────────┬──────────────────────────┘  │
└─────────────────────┬─────────────────────────────┘
                      │ HTTP/WebSocket (per provider)
┌─────────────────────▼─────────────────────────────┐
│              AI PROVIDERS (Free Tiers)             │
│  chatgpt.com · claude.ai · gemini.google.com     │
│  deepseek.com · flux.ai · kling.kuaishou.com     │
└───────────────────────────────────────────────────┘
```

---

## Benchmarks

| Metric | Finalyy | gpt4free | AIClient2API | OpenProxy |
|--------|---------|----------|--------------|-----------|
| Providers | 20+ built-in · 100+ community | 60+ | 12+ | 40+ (API keys only) |
| MCP Support | ✅ Native | ❌ | ❌ | ❌ |
| Multi-model types | chat, image, video, audio | chat only | chat only | chat only |
| Browser sessions | ✅ Cookie/OAuth capture | ❌ (scraping) | ❌ (CLI apps) | ❌ (API keys) |
| Session health | ✅ Auto-rotate, captcha detect | ❌ | ❌ | ❌ |
| Region routing | ✅ Proxy per provider | ❌ | ❌ | ❌ |
| Community registry | ✅ Auto-updating PR system | ❌ | ❌ | ❌ |
| Encryption at rest | ✅ AES-256-GCM | ❌ | ❌ | ❌ |
| Startup time | < 500ms | — | — | — |
| Memory usage | ~80 MB idle | ~200 MB | ~150 MB | ~30 MB |
| Response latency | +150ms (proxy overhead) | +300-800ms | +200-400ms | +50ms |

---

## Why the Name?

**Finalyy** = **Final** + **Why**.

*"The final answer to 'why do I still need to pay for AI APIs?'"*

---

## License

MIT — free for everyone, forever.

---

## The Finalyy Promise

1. **Always free.** We don't charge. We don't have a paid tier. We never will.
2. **Always open.** Source code, provider registry, community — all open.
3. **Always current.** Providers change. We adapt. Community helps.
4. **Never scam.** No hidden fees. No crypto. No data collection. Just MCP.