aiagenta2z

OneKey Gateway

Community aiagenta2z
Updated

OneKey Agent Gateway access to Commercial APIs, Skills, MCPs Build once and Ship 10× faster. For devs & builders, A unified API registry to serve and distribute across all agent formats—CLI, REST, MCP, and Skills—eliminating multiple builds. Access 30+ categories like search, image, finance, and 3D Rendering, register, and monetize APIs 10× faster

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.

GitHub|Document|AI Agent Marketplace|AI Agent Search | AI Agent A2Z Deployment | Agent A2Z Payment

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 commercialAPI,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 keyYou 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\\\": {\\n        \\\"lat\\\": 40.74458180000001,\\n        \\\"lng\\\": -73.9856202\\n      },\\n      \\\"place_id\\\": \\\"ChIJt8W7n79ZwokRsyXs3QDbE3o\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Osteria Nonnino\\\",\\n      \\\"formatted_address\\\": \\\"637 Hudson St, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7388972,\\n        \\\"lng\\\": -74.0057401\\n      },\\n      \\\"place_id\\\": \\\"ChIJu3WF-z9ZwokRSIlFddmXX1k\\\",\\n      \\\"rating\\\": 4.8,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"OLIO E PIÙ\\\",\\n      \\\"formatted_address\\\": \\\"3 Greenwich Ave, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7338208,\\n        \\\"lng\\\": -73.99979309999999\\n      },\\n      \\\"place_id\\\": \\\"ChIJ_RUJvZZZwokRNUEv3K4nSik\\\",\\n      \\\"rating\\\": 4.7,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Pecora Bianca SoHo\\\",\\n      \\\"formatted_address\\\": \\\"54 Prince St, New York, NY 10012, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.72346,\\n        \\\"lng\\\": -73.9963118\\n      },\\n      \\\"place_id\\\": \\\"ChIJfe6ZYKFZwokR_mHm7GNoAxc\\\",\\n      \\\"rating\\\": 4.8,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Osteria Barocca\\\",\\n      \\\"formatted_address\\\": \\\"133 Mulberry St, New York, NY 10013, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7186467,\\n        \\\"lng\\\": -73.99792409999999\\n      },\\n      \\\"place_id\\\": \\\"ChIJK0YQvsRZwokR9r2ubFZRd7E\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Sicily Osteria\\\",\\n      \\\"formatted_address\\\": \\\"328-330 W 46th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7601601,\\n        \\\"lng\\\": -73.9891863\\n      },\\n      \\\"place_id\\\": \\\"ChIJ03krMjJZwokRYRF15upaCHw\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Pecora Bianca NoMad\\\",\\n      \\\"formatted_address\\\": \\\"1133 Broadway, New York, NY 10010, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7436754,\\n        \\\"lng\\\": -73.9891719\\n      },\\n      \\\"place_id\\\": \\\"ChIJPf0L06VZwokRD6L-7RV-7Yg\\\",\\n      \\\"rating\\\": 4.7,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Da Andrea Greenwich Village\\\",\\n      \\\"formatted_address\\\": \\\"35 W 13th St, New York, NY 10011, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7361918,\\n        \\\"lng\\\": -73.9958515\\n      },\\n      \\\"place_id\\\": \\\"ChIJS1uszZRZwokRbKPTzS6hnWM\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Via Carota\\\",\\n      \\\"formatted_address\\\": \\\"51 Grove St, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7331959,\\n        \\\"lng\\\": -74.00364940000001\\n      },\\n      \\\"place_id\\\": \\\"ChIJr7FOf5NZwokRu3CDYtzVmuQ\\\",\\n      \\\"rating\\\": 4.4,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Masseria Dei Vini\\\",\\n      \\\"formatted_address\\\": \\\"887 9th Ave, New York, NY 10019, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7684477,\\n        \\\"lng\\\": -73.9857048\\n      },\\n      \\\"place_id\\\": \\\"ChIJeVfr_FhYwokRVM1IjwyvQpE\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"La Masseria NY\\\",\\n      \\\"formatted_address\\\": \\\"235 W 48th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.76088499999999,\\n        \\\"lng\\\": -73.9863\\n      },\\n      \\\"place_id\\\": \\\"ChIJjfIegVZYwokRyqdwvzBC27s\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Zia Maria Little Italy\\\",\\n      \\\"formatted_address\\\": \\\"138 Mulberry St, New York, NY 10013, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7187113,\\n        \\\"lng\\\": -73.9975649\\n      },\\n      \\\"place_id\\\": \\\"ChIJm7QTo_lZwokRRnjGuJABJPQ\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\",\\n        \\\"store\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Piccola Cucina Osteria Siciliana\\\",\\n      \\\"formatted_address\\\": \\\"196 Spring St, New York, NY 10012, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7250308,\\n        \\\"lng\\\": -74.0032774\\n      },\\n      \\\"place_id\\\": \\\"ChIJowhlWYxZwokRgrvA8f_x8Es\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Trattoria Trecolori\\\",\\n      \\\"formatted_address\\\": \\\"254 W 47th St, New York, NY 10036, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7599972,\\n        \\\"lng\\\": -73.9867421\\n      },\\n      \\\"place_id\\\": \\\"ChIJYepwLVRYwokRsvXclA3XFqo\\\",\\n      \\\"rating\\\": 4.5,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Don Angie\\\",\\n      \\\"formatted_address\\\": \\\"103 Greenwich Ave, New York, NY 10014, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7378037,\\n        \\\"lng\\\": -74.00209389999999\\n      },\\n      \\\"place_id\\\": \\\"ChIJfxC19JVZwokRX2uKgQAL17c\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    },\\n    {\\n      \\\"name\\\": \\\"Casa D'Angelo New York\\\",\\n      \\\"formatted_address\\\": \\\"146 Mulberry St, New York, NY 10013, USA\\\",\\n      \\\"location\\\": {\\n        \\\"lat\\\": 40.7188063,\\n        \\\"lng\\\": -73.9972296\\n      },\\n      \\\"place_id\\\": \\\"ChIJCxhnSohZwokRxmUkfrQWLfs\\\",\\n      \\\"rating\\\": 4.6,\\n      \\\"types\\\": [\\n        \\\"bar\\\",\\n        \\\"establishment\\\",\\n        \\\"food\\\",\\n        \\\"point_of_interest\\\",\\n        \\\"restaurant\\\"\\n      ]\\n    }\\n  ]\\n}\"]","error":null}
Example 2: Image Generation

model:

  • gemini-3-pro-image-preview
  • gemini-2.5-flash-image
npx onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{"model":"gemini-2.5-flash-image", "prompt":"Generate a minecraft scene of steve fighting zombies in purple crystal fields."}'
{"success":true,"data":"[\"{\\n  \\\"image_path\\\": \\\"/data/python/mcp_tool_use/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n  \\\"image_url\\\": \\\"https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n  \\\"message\\\": \\\"\\\",\\n  \\\"success\\\": true\\n}\"]","error":null}
## url of image generated
https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png

Return Image URL Result

Example 3: 3D Generation Step By Step Assembly Charts Build Plans

prompt:

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ACCESS_KEY
npx onekey agent craftsman-agent/craftsman-agent generate_lego_build_plan '{"prompt":"Build Lego yacht with 5 decks using blue and white bricks","images":[],"mode":"basic"}' --timeout 60000

3D Step by Step Assembly Charts

Example 4. Generate Tesla Car Wrap

prompt: model YL F1 race car blue and purple with starsmodel: tesla_model_yl

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ACCESS_KEY

npx onekey agent craftsman-agent/craftsman-agent generate_tesla_wraps '{"prompt":"I would like to paint my tesla model YL similar to F1 race car, color of a blue and purple with stars","images":[],"mode":"basic","car_model":"tesla_model_yl","output_number":1}' --timeout 60000
{"success":true,"text":"","images":[{"url":"https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/722aa763-ec48-48b5-acfd-c569f89ffc50.png"}]}

Tutorial

1. OneKey Agent Router Usage

CLI

npx onekey agent <unique_id> <api_id> <data_json|@file> [--timeout <ms>]
npx onekey mcp <server_name> [--name config_name] [--timeout <ms>]
npx onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>] [--timeout <ms>]
npx onekey llm --payload <json|@file> [--timeout <ms>]

Supported ids can be found in the table below.

Skills

You can download skills (wrapper of OneKey Gateway in CLI with SKILL.md) to your local agents, such as claude code, codex, gemini, openclaw.

agtm package to download skills

npx agtm skills add https://github.com/aiagenta2z/onekey-gateway      ## add all onekey router skills
npx agtm skills add aiagenta2z/onekey-gateway --skill google-maps -g  ## install to global path
npx agtm skills add aiagenta2z/onekey-gateway --skill gemini-nano-banana

skills package

npx skills add https://github.com/aiagenta2z/onekey-gateway
## single skill
npx skills add https://github.com/aiagenta2z/onekey-gateway --skill amap-maps-streamableHTTP

API

Set env variable and use curl to get Agent APIs of Google maps

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
curl -v -X POST "https://agent.deepnlp.org/agent_router" \
  -H "Content-Type: application/json" \
  -H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
  -d '{"unique_id":"google-maps/google-maps","api_id":"maps_geocode","data":{"address": "Times Square, New York"}}'

2. OneKey MCP Router

CLI

npx onekey mcp <server_name> [--name config_name] [--timeout <ms>]

Use npx onekey mcp cli to generate the mcp config and copy paste to your clients.

npx onekey mcp google-maps

Put below config into your clients

{
  "mcpServers": {
    "deepnlp-onekey-google-maps": {
      "url": "https://agent.deepnlp.org/mcp?server_name=google-maps&onekey=your_access_key"
    }
  }
}

3. OneKey LLM Router

Call LLM API, such as Gemini 3 Flash Models, Image Generation Model Nano Banana

CLI

npx onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>]
npx onekey llm --payload <json|@file>
npx onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json --timeout 60000

Gateway Support Summary

Domain Unique Id Skill ID API ID
Map (Google) google-maps/google-maps Doc google-maps maps_directionsmaps_distance_matrixmaps_elevationmaps_geocodemaps_place_detailsmaps_reverse_geocodemaps_search_places
Map (Amap/Gaode Map) amap-maps-streamableHTTP/amap-maps-streamableHTTP Doc amap-maps-streamableHTTP maps_around_searchmaps_direction_bicyclingmaps_direction_drivingmaps_direction_transit_integratedmaps_direction_walkingmaps_distancemaps_geomaps_ip_locationmaps_regeocodemaps_schema_navimaps_schema_personal_mapmaps_schema_take_taximaps_search_detailmaps_text_searchmaps_weather
Map (Baidu) baidu-maps-sse/baidu-maps-sse Doc baidu-maps-sse maps_directionsmaps_distance_matrixmaps_elevationmaps_geocodemaps_place_detailsmaps_reverse_geocodemaps_search_places
Image Search bing-image-search-mcp/bing-image-search-mcp Doc bing-image-search-mcp search_imagessearch_images_batch
Web Search brave-search/brave-search Doc brave-search brave_local_searchbrave_web_search
Web Search google-search/google-search Doc google-search google_search
Web Search tavily-remote-mcp/tavily-remote-mcp Doc tavily-remote-mcp tavily_crawltavily_extracttavily_maptavily_researchtavily_search
Web Crawl / Browser firecrawl-mcp/firecrawl-mcp Doc firecrawl-mcp firecrawl_agentfirecrawl_agent_statusfirecrawl_browser_createfirecrawl_browser_deletefirecrawl_browser_executefirecrawl_browser_listfirecrawl_check_crawl_statusfirecrawl_crawlfirecrawl_extractfirecrawl_mapfirecrawl_scrapefirecrawl_search
Image Generation gemini/gemini Doc gemini (Nano Banana) generate_image_geminigenerate_image_nano_bananagenerate_image_nano_banana_with_referenceocr_extract_text_from_imagelist_items_from_image
Image Generation gemini-nano-banana/gemini-nano-banana Doc gemini-nano-banana generate_image_geminigenerate_image_nano_bananagenerate_image_nano_banana_with_referenceocr_extract_text_from_imagelist_items_from_image
Charts mcp-server-chart/mcp-server-chart Doc mcp-server-chart generate_area_chartgenerate_bar_chartgenerate_boxplot_chartgenerate_column_chartgenerate_district_mapgenerate_dual_axes_chartgenerate_fishbone_diagramgenerate_flow_diagramgenerate_funnel_chartgenerate_histogram_chartgenerate_line_chartgenerate_liquid_chartgenerate_mind_mapgenerate_network_graphgenerate_organization_chartgenerate_path_mapgenerate_pie_chartgenerate_pin_mapgenerate_radar_chartgenerate_sankey_chartgenerate_scatter_chartgenerate_spreadsheetgenerate_treemap_chartgenerate_venn_chartgenerate_violin_chartgenerate_waterfall_chartgenerate_word_cloud_chart
Research QA perplexity/perplexity Doc perplexity perplexity_askperplexity_reasonperplexity_researchperplexity_search
3D Generation craftsman-agent/craftsman-agent Doc craftsman-agent generate_lego_build_plangenerate_minecraft_build_plangenerate_tesla_wraps
Finance aiagenta2z/financeagent Doc financeagent get_hk_stock_market_hkexget_cn_stock_market_shanghai_shenzhenget_us_stock_market_nyse_nasdaq_dowget_uk_stock_market_lseget_india_stock_market_nse_india
Healthcare fdcnal/usda-fooddata-central-agent Doc usda-fooddata-central-agent get_foods_multipleget_food_by_idlist_foodssearch_foods
Healthcare aiagenta2z/healthcaregent Doc healthcareagent
Example 1: Google Maps Search
npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
curl -X POST "https://agent.deepnlp.org/agent_router" \
  -H "Content-Type: application/json" \
  -H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
  -d '{
    "unique_id": "google-maps/google-maps",
    "api_id": "maps_search_places",
    "data": {
      "query": "New York City Italian Restaurants"
    }
  }'
Example 2: Image Generation

model:

  • gemini-3-pro-image-preview
  • gemini-2.5-flash-image
npx onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{"model":"gemini-2.5-flash-image", "prompt":"Generate a minecraft scene of steve fighting zombies in purple crystal fields."}'
{"success":true,"data":"[\"{\\n  \\\"image_path\\\": \\\"/data/python/mcp_tool_use/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n  \\\"image_url\\\": \\\"https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n  \\\"message\\\": \\\"\\\",\\n  \\\"success\\\": true\\n}\"]","error":null}

## Return Image url: 
https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png

Supported Agents

Codex

Onekey Gateway Usage
Install
npm -g install @aiagenta2z/onekey-gateway
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a codex
npx skills add https://github.com/aiagenta2z/onekey-gateway
Setup Env

File

vim .env
DEEPNLP_ONEKEY_ROUTER_ACCESS=${your_accesskey}

Export Env

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_accesskey
Run Codex
codex
## Show Skills Loaded
/skills
## Example 1. Generate a image poster academic/business/professional styles
/skills Read the README file and relevant project files to understand the project. Then use Gemini Nano Banana to generate a high-quality image (poster) that visually represents the project in a professional, academic, or business style and output to local folder /docs/*.png

### Example 2. Call Google Maps to Search places
/skills  Use Google Maps Search Best Italian Restaurants in New York
Results
• Updated Plan
  └ ✔ Scan README and project structure
    ✔ Summarize project goals and features
    ✔ Draft poster concept and prompt
    □ Generate poster image via Gemini
    □ Save PNG to docs folder

• Ran npx --yes onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini @docs/poster_request_gemini.json
  └ {"success":true,"data":[{"image_path":"/data/python/mcp_tool_use/files-wd/user_1808/9f03533e-af88-4959-b6b4-0131230728b9/Users/rockingdingo/Desktop/workspace/
    github/aiagenta2z/onekey-gateway-test/docs/onekey_gateway_poster_gemini.png","image_url":"https://us-static.aiagenta2z.com/local/files-wd/
    user_1808/9f03533e-af88-4959-b6b4-0131230728b9/Users/rockingdingo/Desktop/workspace/github/aiagenta2z/onekey-gateway-test/docs/
    onekey_gateway_poster_gemini.png","message":"Here is the OneKey Gateway poster you requested.","success":true}],"error":null}

Gemini-CLI

Onekey Gateway Usage
Install
npm -g install @aiagenta2z/onekey-gateway
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a gemini-cli
npx skills add https://github.com/aiagenta2z/onekey-gateway

Setup Env

File

vim .env
DEEPNLP_ONEKEY_ROUTER_ACCESS=${your_accesskey}

Export Env

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_accesskey
Run Gemini-CLI
gemini
## List if the onekey skills are loaded

/skills list
## Generate a business/academic/professional poster of the architecture of the project
Read the README file and relevant project files to understand the project. Then use Onekey Gateway skills of Gemini Nano Banana to generate a high-quality image (poster) that visually represents the project in a professional, academic, or business style and output to local folder /docs/*.png

### Call Google Maps to Search places
Use onekey gateway skills Google Maps Search Best Italian Restaurants in New York

Claude Code

Onekey Gateway Usage
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a claude-code
claude
> Use Nano Banana to Generate an Image of academic poster of the project
> Search top italian restaurants and add to calendars.

OpenClaw

Onekey Gateway Usage
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a openclaw
> Use Nano Banana to Generate an Image of academic poster of the project
> Search top italian restaurants and add to calendars.

Related

OneKey Gateway Documentation AI Agent Marketplace GitHub Agtm Submit AI Agent Agent Infra Deployment A2Z Payment SDK

MCP Server · Populars

MCP Server · New

    aiagenta2z

    OneKey Gateway

    OneKey Agent Gateway access to Commercial APIs, Skills, MCPs Build once and Ship 10× faster. For devs & builders, A unified API registry to serve and distribute across all agent formats—CLI, REST, MCP, and Skills—eliminating multiple builds. Access 30+ categories like search, image, finance, and 3D Rendering, register, and monetize APIs 10× faster

    Community aiagenta2z
    joeseesun

    🎯 多源内容 → NotebookLM 智能处理器

    Claude Skill: Multi-source content processor for NotebookLM. Supports WeChat articles, web pages, YouTube, PDF, Markdown, search queries → Podcast/PPT/MindMap/Quiz etc.

    Community joeseesun
    sgroy10

    speclock

    AI Constraint Engine — enforces CLAUDE.md, .cursorrules, AGENTS.md rules as laws. 51 MCP tools, 991 tests. Official MCP Registry. npx speclock protect

    Community sgroy10
    googleapis

    MCP Toolbox for Databases

    MCP Toolbox for Databases is an open source MCP server for databases.

    Community googleapis
    kamelirzouni

    Qwen Max MCP Server

    MCP server for Qwen Max model

    Community kamelirzouni