OneKey Gateway

AI Agent Gateway to Commercial APIs, Skills, MCPs and more using just one access key for image,3d,video,audio all in one Agent usage. Registry your APIs and omni converter to other formats: API2MCP,API2Skills,API2CLI and more. Publish AI Generated Digital assets 3D model to marketplace and gallery for online views.

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, video and audio generation 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.

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 | CLIs | Description | BASE URL | |--------------|----------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|----------------------------------------| | Agent APIs | npx onekey agent <unique_id> | Allow your AI Agent to Access APIs OneKey Agent Router Doc | https://agent.deepnlp.org/agent_router | | MCP | npx onekey mcp <unique_id> | Allow your AI clients to connect to commercial Http MCP OneKey MCP Router Doc | https://agent.deepnlp.org/mcp | | LLM | npx onekey llm <unique_id> | Allow your AI clients to call LLM endpoint proxy OneKey LLM Router Doc | https://agent.deepnlp.org/llm | | Publish | npx onekey publish <unique_id> | Allow AI Agents to upload your Digital Assets to Gallery and Marketplace Endpoints to visualize, share and view | - |

Want to register your API? See the top ranked onekey gateway called Agent API Skills MCP Calls Ranking

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

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.

                   ┌─────────────┐
                   │   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 install @aiagenta2z/onekey-gateway

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=xxxxxx

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 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

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 stars model: 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}'

{"success":true,"text":"","images":[{"url":"https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/722aa763-ec48-48b5-acfd-c569f89ffc50.png"}]}

Tutorial

CLI Usage

onekey agent <unique_id> <api_id> <data_json|@file>

Supported ids can be found in the table below.

1. OneKey Agent API

CLI

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

Skills

agtm package

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

skills package

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

Run onekey skills with hint

npx agtm run nano # -> guide you through gemini-nano-banana tools
npx agtm run nano aiagenta2z/onekey-gateway nano # -> Find the cli of generation or generation with reference images

2. OneKey MCP Usage

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 Usage

Call Gemini 3 LLM and Image Nano Banana model

onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json --timeout 60000

Gateway Categories

| 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

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

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

4. OneKey Publish CLI

Use OneKey Agent Gateway publish commands to uploaded and share your local generated session digital assets and get online public URL, online viewer of 3d model (.obj,.glb,.stl). Especially you just finished the design of 3d models or lego build instructions and you want to publish to gallery or 3d model marketplace. You can use the clis to publish, sell, make manufacturing-on-demand orders on Craftsman-Agent Store, Craftsman Agent Gallery and Craftsman Agent Products Marketplace.

## The access key related user name will be identified as personal folder directory. 

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
export PROJECT_PATH="YOUR_LOCAL_PROJECT_PATH"
npx onekey publish craftsman-agent/craftsman-agent \
    --title "Swimming Boy AI Figurine Toy Design" \
    --files "${PROJECT_PATH}/swimming_boy/swimming_boy_3d_model.glb"

Full supported parameters, please read the Docs .

Example of 3D online viewer of the Swimming Boys

{
  "success": true,
  "message": "Uploaded successfully",
  "session_id": "d973addb-9b4e-4f44-8205-a29b80a88e5a",
  "product_url": "https://craftsman-agent.aiagenta2z.com/marketplace/product/d973addb-9b4e-4f44-8205-a29b80a88e5a",
  "gallery_url": "https://craftsman-agent.aiagenta2z.com/app/sessions/share/d973addb-9b4e-4f44-8205-a29b80a88e5a"
}

Gallery URL

https://craftsman-agent.aiagenta2z.com/app/sessions/share/d973addb-9b4e-4f44-8205-a29b80a88e5a

Online Viewer and Share URL of the 3d generator generated files

Product URL

https://craftsman-agent.aiagenta2z.com/marketplace/product/d973addb-9b4e-4f44-8205-a29b80a88e5a

Set willing manufacturing price per unit, manufacturing minimum order quantity, and place intent-order as quote. Craftsman will seize the order, if no one are likely to take the manufacturing order, within 1 week it will be closed and credits returned to your account.

Edit or Delete the published files

Go to the detail view, click the edit button, update fields value or delete. To edit the gallery profile, Visit the workspace to select the latest session at the url following the formats

https://craftsman-agent.aiagenta2z.com/app/sessions/admin/{session_id}token={pwd}

Related

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