<div align="center">

# 🔮 MCP Omni-Tool

### Stop installing 50 MCP servers. Install one.

**One MCP server. Thousands of APIs. Zero config headaches.**

[![npm version](https://img.shields.io/npm/v/mcp-omni-tool?style=flat-square&color=cb3837)](https://www.npmjs.com/package/mcp-omni-tool)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-6366f1?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIgZmlsbD0id2hpdGUiLz48L3N2Zz4=)](https://modelcontextprotocol.io)

<br />

> Your AI agent shouldn't need 50 different MCP servers to be useful.
> It needs **one** that connects to everything.

<br />

[Get Started →](#-quick-start) · [See Examples →](#-usage) · [Get $5 Free Credit →](#-5-free-credit-for-new-signups)

</div>

---

## 🤯 The Problem

Every new API your agent needs = another MCP server to find, install, configure, and maintain.

Want Slack, GitHub, Stripe, Twilio, and 46 other services? That's 50 `package.json` entries, 50 sets of API keys, 50 things that can break on update.

**There's a better way.**

## ⚡ The Solution

MCP Omni-Tool is a single MCP server powered by [AgentClear](https://agentclear.dev) that gives your AI agent **dynamic access to thousands of APIs** through one install and one API key.

Your agent **discovers** what it needs, then **calls it** — all through a unified proxy. No per-service config. No dependency hell.

```
┌─────────────┐      ┌──────────────────┐      ┌──────────────────────┐
│  Your Agent  │─────▶│  MCP Omni-Tool   │─────▶│  AgentClear Gateway  │
│  (Claude,    │      │  (1 MCP server)  │      │                      │
│   Cursor,    │      │                  │      │  Slack ─ GitHub      │
│   etc.)      │◀─────│                  │◀─────│  Stripe ─ Twilio     │
└─────────────┘      └──────────────────┘      │  Notion ─ Linear     │
                                                │  ... 1000s more      │
                                                └──────────────────────┘
```

---

## 🚀 Quick Start

### 1. Install

```bash
npm install -g mcp-omni-tool
```

### 2. Get Your API Key

Sign up at [agentclear.dev](https://agentclear.dev) and grab your key (starts with `axk_`).

> 🎁 **Every new account gets $5 in free credit** — no card required.

### 3. Configure

Add to your MCP client config (e.g. `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "omni-tool": {
      "command": "mcp-omni-tool",
      "env": {
        "AGENTCLEAR_API_KEY": "axk_your_key_here"
      }
    }
  }
}
```

### 4. Go

That's it. Your agent now has access to thousands of APIs.

---

## 📖 Usage

MCP Omni-Tool exposes two core operations to your agent:

### `discover` — Find Available APIs

Your agent calls `discover` to search for services matching what it needs.

```json
POST https://agentclear.dev/api/discover

{
  "query": "send a Slack message",
  "api_key": "axk_your_key_here"
}
```

**Response:**

```json
{
  "services": [
    {
      "service_id": "slack_post_message",
      "name": "Slack — Post Message",
      "description": "Send a message to a Slack channel or DM",
      "parameters": {
        "channel": "string (required)",
        "text": "string (required)",
        "thread_ts": "string (optional)"
      }
    }
  ]
}
```

### `proxy` — Call Any Discovered API

Once discovered, your agent calls the service directly through the proxy:

```json
POST https://agentclear.dev/api/proxy/slack_post_message

{
  "api_key": "axk_your_key_here",
  "params": {
    "channel": "#general",
    "text": "Deployed v2.4.1 to production ✅"
  }
}
```

**That's the entire pattern.** Discover → Proxy. Your agent figures out the rest.

---

## 📊 Why Omni-Tool?

| | 50 Individual MCP Servers | 1 MCP Omni-Tool |
|---|---|---|
| **Install** | 50 packages, 50 configs | 1 package, 1 key |
| **API Keys** | Manage 50 separate keys | 1 AgentClear key |
| **Updates** | 50 packages to keep current | 1 package, always current |
| **New APIs** | Find → install → configure → restart | Already there. Just call it. |
| **Agent Complexity** | Must know which server handles what | Discovers capabilities dynamically |
| **Failure Surface** | 50 potential breaking points | 1 stable gateway |
| **Setup Time** | Hours | **2 minutes** |
| **Cost** | $0 + your time × 50 | **$5 free to start** |

---

## 🎁 $5 Free Credit for New Signups

Every new AgentClear account gets **$5 in free credit** — no credit card required.

That's enough for hundreds of API calls to test integrations, build prototypes, or just see what your agent can actually do when it has access to everything.

**→ [Sign up at agentclear.dev](https://agentclear.dev)**

---

## 💰 Framework Authors & Template Builders: Earn 40% Revenue Share

Building an MCP-powered template, framework, starter kit, or boilerplate?

**Bundle MCP Omni-Tool and earn 40% of the revenue** generated by users who sign up through your referral.

### How it works:

1. Include MCP Omni-Tool in your project's MCP config
2. Register as a referral partner at [agentclear.dev/partners](https://agentclear.dev/partners)
3. Add your referral tag to the config
4. Earn **40% rev-share** on every user who activates through your template

This isn't an afterthought affiliate program — it's a core part of the model. We want framework authors to win when their users succeed.

**→ [Become a Partner](https://agentclear.dev/partners)**

---

## 🔧 Supported Clients

MCP Omni-Tool works with any MCP-compatible client:

- **Claude Desktop**
- **Cursor**
- **Windsurf**
- **Continue**
- **Custom MCP integrations**

---

## 🔑 API Key Format

All AgentClear API keys start with `axk_` followed by a unique token:

```
axk_a1b2c3d4e5f6...
```

Keep your key secure. You can rotate keys at any time from the [AgentClear dashboard](https://agentclear.dev/dashboard).

---

## 📝 License

MIT © [AgentClear](https://agentclear.dev)

---

<div align="center">

**Built by [AgentClear](https://agentclear.dev)** — the universal API gateway for AI agents.

[Get Started](https://agentclear.dev) · [Documentation](https://agentclear.dev/docs) · [Partner Program](https://agentclear.dev/partners)

</div>