Agent skill

HTTP API Cloudbase

by TencentCloudBase in TencentCloudBase/CloudBase-AI-Toolkit

CloudBase official HTTP API client guide. An agent skill from TencentCloudBase/CloudBase-AI-Toolkit.

MITAuto-check passedBackend & APIs

Install HTTP API Cloudbase

skills CLI
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill http-api-cloudbase -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit http-api-cloudbase --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/config/source/skills/http-api-cloudbase .claude/skills/http-api-cloudbase && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
http-api-cloudbase
GitHub stars
1.1k
Used in
3 other repos
Token cost
~2.1k tokens
SKILL.md length
930 words
Files
3 (incl. references)
Skills in repo
49
Repo updated
First seen
Licence
MIT

At a glance

CloudBase official HTTP API client guide. An agent skill from TencentCloudBase/CloudBase-AI-Toolkit.

  • Works in 4 steps: Clarify the scenario → Determine the base URL → Set up authentication → …
  • Tasks that involve REST APIs
  • SKILL.md covers Sibling skills (local only), Activation Contract, When to use this skill and How to use this skill (for a…, plus 8 more sections
  • Reaches cloud1-abc.api.tcloudbasegateway.com and cloud1-abc.api.intl.tcloudbasegateway.com

What it does

HTTP API Cloudbase is an agent skill from TencentCloudBase/CloudBase-AI-Toolkit. CloudBase official HTTP API client guide. This skill should be used when backends, scripts, or non-SDK clients must call CloudBase platform APIs over raw HTTP instead of using a platform SDK or MCP management tool.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `checklist.md` and `references/extended-guide.md`).

It sits in Backend & APIs, covering REST APIs and MCP servers. It works with OpenAPI. The repository describes itself as: Backend for AI coding agents on CloudBase — database, auth, functions via Plugin, Skills & MCP. The licence is MIT.

When your agent uses it

  • Tasks that involve REST APIs
  • Tasks that involve MCP servers

Example prompts

  • “/http-api-cloudbase”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Clarify the scenario
  2. Determine the base URL
  3. Set up authentication
  4. Reference OpenAPI Swagger documentation

What it can do on your machine

Read from SKILL.md and the folder at commit ea2c202. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are http).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • cloud1-abc.api.tcloudbasegateway.com
    • cloud1-abc.api.intl.tcloudbasegateway.com

    Also links to:

    • tcb.cloud.tencent.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

HTTP API Cloudbase loads about 2.1k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 930 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TencentCloudBase/CloudBase-AI-Toolkit at commit ea2c202, republished under its MIT licence (© TencentCloudBase). 930 words, ~2,093 tokens.

Download SKILL.mdSave it as .claude/skills/http-api-cloudbase/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
http-api-cloudbase
description
CloudBase official HTTP API client guide. This skill should be used when backends, scripts, or non-SDK clients must call CloudBase platform APIs over raw HTTP instead of using a platform SDK or MCP management tool.
version
2.34.8
alwaysApply
false

Sibling skills (local only)

Sibling CloudBase skills ship beside this skill. Use local relative paths such as ../auth-tool-cloudbase/SKILL.md.

If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do not HTTP-fetch remote skill or protocol markdown into the agent context.

Activation Contract

Use this first when
  • The request comes from Android, iOS, Flutter, React Native, non-Node backends, or admin scripts that must call official CloudBase APIs via raw HTTP.
  • The task is to consume CloudBase platform endpoints, not to build a new HTTP service on CloudBase.
Read before writing code if
  • The platform does not support a CloudBase SDK, or the user explicitly asks for HTTP API integration.
  • The user says "HTTP API" but it is unclear whether they mean official CloudBase endpoints or their own business API.
Then also read
  • Auth configuration -> ../auth-tool-cloudbase/SKILL.md
  • MySQL MCP management -> ../relational-database-mcp-cloudbase/SKILL.md
  • Your own HTTP service on CloudBase -> ../cloud-functions/SKILL.md or ../cloudrun-development/SKILL.md
Do NOT use for
  • CloudBase Web SDK flows, mini program SDK flows, or MCP-driven management tasks.
  • Building your own HTTP service or REST API on CloudBase.
Common mistakes / gotchas
  • Treating Web SDK examples as valid for native Apps.
  • Guessing endpoints without reading OpenAPI definitions.
  • Confusing official CloudBase HTTP APIs with your own function or CloudRun endpoint.
  • Mixing raw HTTP API integration with MCP management logic.
Minimal checklist

When to use this skill

Use this skill whenever you need to call CloudBase platform features via raw HTTP APIs, for example:

  • Non-Node backends (Go, Python, Java, PHP, etc.)
  • Integration tests or admin scripts that use curl or language HTTP clients
  • Direct database operations via 关系型数据库 RESTful API (MySQL/PostgreSQL)
  • Cloud function invocation via HTTP
  • Any scenario where SDKs are not available or not preferred

Do not use this skill for:

  • Frontend Web apps using @cloudbase/js-sdk (use CloudBase Web skills)
  • Node.js code using @cloudbase/node-sdk (use CloudBase Node skills)
  • Authentication flows (use CloudBase Auth HTTP API skill for auth-specific endpoints)

How to use this skill (for a coding agent)

  1. Clarify the scenario

    • Confirm this code will call HTTP endpoints directly (not SDKs).
    • Ask for:
      • env – CloudBase environment ID
      • Authentication method (AccessToken, API Key, or Publishable Key)
    • Confirm which CloudBase feature is needed (database, functions, storage, etc.).
    • For user authentication: If no specific method is requested, always default to Phone SMS Verification - it's the most user-friendly and secure option for Chinese users.
  2. Determine the base URL

    • Use the correct domain based on region (domestic vs. international).
    • Default is domestic Shanghai region.
  3. Set up authentication

    • Choose appropriate authentication method based on use case.
    • Add Authorization: Bearer <token> header to requests.
  4. Reference OpenAPI Swagger documentation

    • MUST use searchKnowledgeBase tool to get OpenAPI specifications
    • Use the tool with mode=openapi and specify the apiName:
      • mysqldb - 关系型数据库 RESTful API (MySQL/PostgreSQL)
      • nosql - NoSQL RESTful API (文档型数据库)
      • functions - Cloud Functions API
      • auth - Authentication API
      • cloudrun - CloudRun API
      • storage - Storage API
      • ai_model - AI 大模型接入 API
    • Example: searchKnowledgeBase({ mode: "openapi", apiName: "mysqldb" })
    • Parse the returned YAML content to understand exact endpoint paths, parameters, request/response schemas
    • Never invent endpoints or parameters - always reference the swagger documentation

Overview

CloudBase HTTP API is a set of interfaces for accessing CloudBase platform features via HTTP protocol, supporting database, user authentication, cloud functions, cloud hosting, cloud storage, AI, and more.

Show full SKILL.md (383 more words)Show less

OpenAPI Swagger Documentation

⚠️ IMPORTANT: Always use searchKnowledgeBase tool to get OpenAPI Swagger specifications

Before implementing any HTTP API calls, you should:

  1. Use searchKnowledgeBase tool to get OpenAPI documentation:

    searchKnowledgeBase({ mode: "openapi", apiName: "<api-name>" })
  2. Available API names:

    • mysqldb - 关系型数据库 RESTful API (MySQL/PostgreSQL)
    • nosql - NoSQL RESTful API (文档型数据库)
    • functions - Cloud Functions API
    • auth - Authentication API
    • cloudrun - CloudRun API
    • storage - Storage API
    • ai_model - AI 大模型接入 API
  3. Parse and use the swagger documentation:

    • Extract exact endpoint paths and HTTP methods
    • Understand required and optional parameters
    • Review request/response schemas
    • Check authentication requirements
    • Verify error response formats
  4. Never invent API endpoints or parameters - always base your implementation on the official swagger documentation.

Prerequisites

Before starting, ensure you have:

  1. CloudBase environment created and activated
  2. Authentication credentials (AccessToken, API Key, or Publishable Key)

Authentication and Authorization

CloudBase HTTP API requires authentication. Choose the appropriate method based on your use case:

AccessToken Authentication

Applicable environments: Client/Server
User permissions: Logged-in user permissions

How to get: Use searchKnowledgeBase({ mode: "openapi", apiName: "auth" }) to get the Authentication API specification

API Key

Applicable environments: Server
User permissions: Administrator permissions

⚠️ Warning: Tokens are critical credentials for identity authentication. Keep them secure. API Key must NOT be used in client-side code.

Publishable Key

Applicable environments: Client/Server
User permissions: Anonymous user permissions

💡 Note: Can be exposed in browsers, used for requesting publicly accessible resources, effectively reducing MAU.

API Endpoint URLs

CloudBase HTTP API uses unified domain names for API calls. The domain varies based on the environment's region.

Domestic Regions

For environments in domestic regions like Shanghai (ap-shanghai), use:

text
https://{your-env}.api.tcloudbasegateway.com

Replace {your-env} with the actual environment ID. For example, if environment ID is cloud1-abc:

text
https://cloud1-abc.api.tcloudbasegateway.com
International Regions

For environments in international regions like Singapore (ap-singapore), use:

text
https://{your-env}.api.intl.tcloudbasegateway.com

Replace {your-env} with the actual environment ID. For example, if environment ID is cloud1-abc:

text
https://cloud1-abc.api.intl.tcloudbasegateway.com

Using Authentication in Requests

Add the token to the request header:

http
Authorization: Bearer <access_token/apikey/publishable_key>

:::warning Note

When making actual calls, replace the entire part including angle brackets (< >) with your obtained key. For example, if the obtained key is eymykey, fill it as:

http
Authorization: Bearer eymykey

:::

Extended guide

For detailed scenarios, examples, and patterns, read extended-guide.md.

Reference index

All packaged reference files (required for skill lint reachability):

© TencentCloudBase, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in config/source/skills/http-api-cloudbase of TencentCloudBase/CloudBase-AI-Toolkit.

  • SKILL.md
  • checklist.md
  • references/extended-guide.md

Open the folder on GitHubat commit ea2c202

Used in 3 other repositories

We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in TencentCloudBase/CloudBase-AI-Toolkit, which our catalogue first saw on October 7, 2026.

Compare with similar skills

HTTP API Cloudbase next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

HTTP API Cloudbase compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
HTTP API Cloudbase this skillTencentCloudBase/CloudBase-AI-Toolkit1.1k3 repos~2.1kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
API Endpoint Contracttrycompai/comp2k—~2.7kAutomated safety check: PassAGPL-3.0
API Endpointslatitude-dev/latitude-llm4.7k—~6.5kAutomated safety check: PassMIT
API DesignerJeffallan/claude-skills12k2 repos~2kAutomated safety check: PassMIT
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT

Similar skills

  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • API Endpoint Contract

    trycompai/comp

    The contract every new or modified API endpoint must follow so it is correct for the public OpenAPI spec, the MCP server (npm @trycompai/mcp-server), the ValidationPipe, and the docs.

    2k GitHub stars~2.7k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • API Endpoints

    latitude-dev/latitude-llm

    Adding or changing API operations in @repo/operations. An agent skill from latitude-dev/latitude-llm.

    4.7k GitHub stars~6.5k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Use whenever asked to add, create, or scaffold a CRUD endpoint, router, or entity in this repo's server (create/list/get/update/delete handlers, new…

    23k GitHub stars~461 tokensUpdated today
    Backend & APIsAuto-check passed

More from TencentCloudBase/CloudBase-AI-Toolkit

All 49 skills in this repo
  • AI Model Nodejs

    TencentCloudBase/CloudBase-AI-Toolkit

    A skill your agent uses for Node.js backend AI via @cloudbase/node-sdk (=3.16.0) — cloud functions, CloudRun, Express/Koa/NestJS, serverless APIs, scheduled jobs, LLM proxies, agent orchestration.

    1.1k GitHub starsUsed in 3 repos~5k tokens
    Auto-check passed
  • Cloud API Recipe Authoring

    TencentCloudBase/CloudBase-AI-Toolkit

    Author or revise a cloud-api-operations recipe (config/source/skills/cloud-api-operations/references/recipes/).

    1.1k GitHub stars~3.7k tokensUpdated yesterday
    Auto-check passed
  • Manage Local Skills

    TencentCloudBase/CloudBase-AI-Toolkit

    Analyze, standardize, validate, and sync locally maintained skills into agent skill directories with a skills CLI-aligned workflow.

    1.1k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Cloudbase Agent Python

    TencentCloudBase/CloudBase-AI-Toolkit

    Build production-ready AI agent backends using the CloudBase Agent Python SDK — create agents with LangGraph/CrewAI/LlamaIndex, serve them via FastAPI with AG-UI protocol streaming +…

    1.1k GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check: notes
  • Cloudbase

    TencentCloudBase/CloudBase-AI-Toolkit

    A skill your agent uses when you develop, design, build, deploy, debug, migrate, or troubleshoot CloudBase (腾讯云开发, 云开发, TCB, 微信云开发) projects — Web, 微信小程序, 小程序, uni-app, mobile (iOS, Android…

    1.1k GitHub starsUsed in 1 repo~4.7k tokens
    Auto-check passed
  • Cloudbase Declarative Deploy

    TencentCloudBase/CloudBase-AI-Toolkit

    CloudBase declarative deployment from a cloudbaserc config (声明式部署, 配置式部署, cloudbaserc 部署) through the deployBuild / deployPlan / deployApply MCP tools.

    1.1k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check passed

Works with

Categories

Questions about HTTP API Cloudbase

What does HTTP API Cloudbase do?

CloudBase official HTTP API client guide. An agent skill from TencentCloudBase/CloudBase-AI-Toolkit. HTTP API Cloudbase is an agent skill from TencentCloudBase/CloudBase-AI-Toolkit. CloudBase official HTTP API client guide.

When should I use HTTP API Cloudbase?

HTTP API Cloudbase fits situations like: tasks that involve REST APIs; tasks that involve MCP servers.

How do I install HTTP API Cloudbase in Claude Code?

Run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill http-api-cloudbase -a claude-code`. Or copy the skill folder (config/source/skills/http-api-cloudbase in TencentCloudBase/CloudBase-AI-Toolkit) into .claude/skills/http-api-cloudbase in your project. Claude Code loads it when a task matches its description.

How do I install HTTP API Cloudbase in Codex?

Run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill http-api-cloudbase -a codex`. Or copy the skill folder (config/source/skills/http-api-cloudbase in TencentCloudBase/CloudBase-AI-Toolkit) into .agents/skills/http-api-cloudbase in your project. Codex loads it when a task matches its description.

Can I use HTTP API Cloudbase in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill http-api-cloudbase -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/http-api-cloudbase, .gemini/skills/http-api-cloudbase, .github/skills/http-api-cloudbase and .opencode/skills/http-api-cloudbase in your project.

What does HTTP API Cloudbase need to run?

SKILL.md names no scripts, command-line tools or credentials: HTTP API Cloudbase is instructions for the agent only. Our summary lists: Node.js.

Does HTTP API Cloudbase access the network?

SKILL.md names 3 domains. In commands or code: cloud1-abc.api.tcloudbasegateway.com and cloud1-abc.api.intl.tcloudbasegateway.com; the agent is likely to contact these when it follows the instructions. As links in the text: tcb.cloud.tencent.com. This is read from the text; nothing was executed.

Is HTTP API Cloudbase safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does HTTP API Cloudbase use?

HTTP API Cloudbase is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does HTTP API Cloudbase use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4k tokens, read only when the agent opens those files.

What are the alternatives to HTTP API Cloudbase?

Skills that share tags, products or a category with HTTP API Cloudbase: OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars), API Endpoint Contract (trycompai/comp, 2k stars), API Endpoints (latitude-dev/latitude-llm, 4.7k stars) and API Designer (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains HTTP API Cloudbase?

TencentCloudBase (a GitHub organization) maintains it in TencentCloudBase/CloudBase-AI-Toolkit, which has 1,132 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 6, 2026.

Source: TencentCloudBase/CloudBase-AI-Toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.