OneKey Gateway

AI Agent Gateway to Commercial APIs, Skills, MCPs and more using just one access key for most benefits. Registry your APIs once and enjoy omni converter to other agent formats 10x faster: API2MCP,API2Skills,API2CLI and more.

Onekey Gateway focuses on commercial agent APIs/MCPs/Skills, which typically require multiple subscriptions or access keys for web search,image generation, financial data, 3D rendering. Our mission is to help users authenticate once and enjoy the most benefits, discounted, pay-as-you-go usage. Accessing Agent APIs, MCPs, and LLMs across 30+ categories and 100+ tools via our credit system, you can eliminate multiple expensive subscriptions and maximize your benefits. More SOTA agent/models are available in the DeepNLP AI Agent Mareketplace.

Top Ranked Agent API(Skills/CLI)/MCPs Dashboard

Overview

OneKey Gateway Document

OneKey Gateway provides CLI tool, Restful API, MCP, Skills and Python/Typescript methods for Agent and human to use commercial Agent APIs.

| Gateway Type | Description | BASE URL | CLI |
|-------------|---------------------------------------------------------------------------------------------------------------|----------------------------------------|----------------|
| Agent APIs | Allow your AI Agent to Access APIs OneKey Agent Router Doc | https://agent.deepnlp.org/agent_router | npx onekey agent | | MCP | Allow your AI clients to connect to commercial Http MCP OneKey MCP Router Doc | https://agent.deepnlp.org/mcp | npx onekey mcp | | LLM | Allow your AI clients to call LLM endpoint proxy OneKey LLM Router Doc | https://agent.deepnlp.org/llm | npx onekey llm |

Want to register your API to OneKey Agent Gateway? See the Registry Documents and top ranked onekey gateway APIs Agent API Skills MCP Calls Ranking

| Gateway Type | Description | |---------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------| | Register Your New API | OneKey Gateway Registry Online Documents, Documents GitHub |

Architecture

This is an example of how onekey-gateway can help you and your AI agents to use commercial API,Skills and MCPs in one single gateway.

OneKey Gateway Agent/Skills/MCP Conversion Matrix

Register and maintain your APIs/MCP Servers only once, AI Agent Marketplace registry and convert to other formats 10x faster, supported APIs/CLIs/Skills/Rest API/MCPs

| From \ To | API | CLI | Skills | Routed API | MCPs (StreamingHTTP) | MCPs (Stdio Local) | |---------------------|-----|-----|--------|------------|----------------------|--------------------| | API | - | ✅ | ✅ | ✅ | ✅ | - | | CLI | - | - | ✅ | - | - | ✅ | | Skills | - | - | - | - | ✅ | ✅ | | Routed API | - | - | - | - | - | - | | MCPs (Streaming HTTP) | - | - | - | - | - | - | | MCPs (Stdio Local) | - | - | - | - | - | - |

                   ┌─────────────┐
                   │   Client    │
                   │ (App / CLI) │
                   └─────┬───────┘
                         │
                         ▼
                ┌───────────────────┐
                │ OneKey Gateway    │
                │───────────────────│
                │ • Authentication  │
                │ • Security        │
                │ • Billing/Quotas  │
                │ • Rate Limiting   │
                └─────┬─────────────┘
                         │
                         ▼
                 ┌──────────────────┐
                 │  OneKey Router   │
                 ├──────────────────┤
                 │ • Routes requests│
                 │ • Load balances  │
                 │ • Policy checks  │
                 └─────┬────────────┘
          ┌────────────┼────────────┐
          ▼            ▼            ▼
 ┌────────────────┐ ┌────────────────┐ ┌────────────────┐
 │ Agent Router   │ │ MCP Router     │ │ LLM Router     │
 │ (Agents /      │ │ (Tools / MCPs) │ │ (LLM Providers)│
 │ Skills)        │ │                │ │                │
 └─────┬──────────┘ └─────┬──────────┘ └─────┬──────────┘
       │                  │                  │
       ▼                  ▼                  ▼
 ┌─────────────┐   ┌─────────────┐    ┌─────────────┐
 │ Execution   │   │ Execution   │    │ Execution   │
 │ Layer       │   │ Layer       │    │ Layer       │
 │ • APIs      │   │ • MCP       │    │ • LLM       │
 │ • Orchest   │   │Servers/Tools│    │ Providers   │
 └─────┬───────┘   └─────┬───────┘    └─────┬───────┘
       ▼                  ▼                  ▼
 ┌──────────────────────────────────────────────┐
 │           Provider APIs / External Services  │
 │ • LLM APIs, SaaS tools, Databases, etc.      │
 └──────────────────────────────────────────────┘

Install

npm -g install @aiagenta2z/onekey-gateway

Test installation if run onekey got permission denied, run from npx

npx onekey

OneKey Access Key

Step 1. Get AI Agent A2Z OneKey access key You can get the OneKey Gateway Access Keys.

Step 2. Set OneKey Access

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

For demo purpose, use the demo key for demo results.

export DEEPNLP_ONEKEY_ROUTER_ACCESS=BETA_TEST_KEY_MAR_2026

The CLI reads the access key from DEEPNLP_ONEKEY_ROUTER_ACCESS. If not set, it falls back to BETA_TEST_KEY_MARCH_2026.

Quickstart

OneKey Gateway CLI

Example 1: Google Maps

Your Agent will search Google Maps to find places, rankings, etc. prompt: New York City Italian Restaurants

npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'

Result

{"success":true,"data":"[\"{\\n  \\\"places\\\": [\\n    {\\n      \\\"name\\\": \\\"Carmine's - Time Square\\\",\\n      \\\"formatted_address\\\": \\\"200 W 44th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.757498,\\n        \\\"lng\\\": -73.986654\\n      },\\n      \\\"place_id\\\": \\\"ChIJR9So-lRYwokRX1xEjA0rChA\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Osteria La Baia\\\",\\n      \\\"formatted_address\\\": \\\"129 W 52nd St, New York, NY 10019, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7618881,\\n        \\\"lng\\\": -73.9809702\\n      },\\n      \\\"place_id\\\": \\\"ChIJo9FTvDBZwokRFAZ0i4jbLuk\\\",\\n      \\\"rating\\\": 4.9,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Tony's Di Napoli\\\",\\n      \\\"formatted_address\\\": \\\"147 W 43rd St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7564842,\\n        \\\"lng\\\": -73.9853808\\n      },\\n      \\\"place_id\\\": \\\"ChIJVS2qI1VYwokRFo18YsKvHYM\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Lanterna di Vittorio\\\",\\n      \\\"formatted_address\\\": \\\"129 MacDougal St, New York, NY 10012, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7306651,\\n        \\\"lng\\\": -74.0000496\\n      },\\n      \\\"place_id\\\": \\\"ChIJPxCEeZFZwokRzk5UghlXZWU\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"cafe\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"night_club\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\",\\n        \\\"store\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Scarpetta\\\",\\n      \\\"formatted_address\\\": \\\"88 Madison Ave, New York, NY 10016, USA\\\",\\n      \\\"location\\\": {\\

Onekey Gateway

Install / Use

README