API REFERENCE

Extend API

REST endpoints behind the Skills, MCP-server, Marketplace, Character and Plugin directories — list, search, create, fork and like catalog items programmatically.

All read endpoints (GET) are public — no API key required. Write endpoints (create, update, delete, like, fork) authenticate via your dashboard login session, so they are meant for the website and for tooling that shares its cookie jar.

List endpoints share one contract: ?search= + ?tags= filters with ?page= / ?limit= pagination, and a paged envelope such as { "skills": [...], "total": 17569, "page": 0, "limit": 30 }.

Parameter	Type	Required	Description
search	string	Optional	Free-text filter over name, description and tags.
tags	string	Optional	Comma-separated tag list. An item matches when it carries at least one of the given tags.
page	integer	Optional	Zero-based page index. Default 0.
limit	integer	Optional	Items per page, 1–100. Default 30.

Skills

The catalog behind the skills directory — 17,000+ agent skills, searchable and forkable. The Agent Skills guide covers what skills are and how to install them.

GEThttps://api.airforce/v1/skills?search=git&tags=devops&page=0&limit=30

GEThttps://api.airforce/v1/skills/:id

GEThttps://api.airforce/v1/skill-tags?search=dev

POSThttps://api.airforce/v1/skills/:id/like — session auth

POSThttps://api.airforce/v1/skills/:id/fork — session auth

Example

curl "https://api.airforce/v1/skills?search=commit&limit=2"

# {
#   "skills": [
#     {
#       "id": "sk_4f2a…",
#       "name": "Conventional Commits",
#       "description": "Rewrites commit messages to the Conventional Commits spec.",
#       "creator_username": "airforce",
#       "official": true,
#       "tags": ["git", "devops"],
#       "likes": 412, "use_count": 12830, "forks": 37,
#       "body": { "system_prompt": "…", "param_hints": { "temperature": 0.2 } }
#     }
#   ],
#   "total": 211, "page": 0, "limit": 2
# }

Skill fields

Parameter	Type	Required	Description
id	string	Optional	Skill identifier — use it for GET / fork / like calls and for installing via the MCP server or directory UI.
name / description	string	Optional	Display name and short summary.
creator_username	string	Optional	Author. Official first-party skills additionally carry official: true.
body	object	Optional	The skill behaviour: a system_prompt and/or ordered input-rewrite rules, plus optional parameter hints (temperature, top_p, max_tokens, reasoning_effort). Hints never override values you set explicitly.
tags	array	Optional	Free-form labels used by the tags filter.
likes / use_count / forks	integer	Optional	Community stats. forked_from links back to the source skill when the skill is a fork.

Authoring endpoints exist too: POST /v1/skills creates a skill, PUT / DELETE /v1/skills/:id manage your own, and GET /v1/skills/user lists everything you created (any visibility). All of them require the dashboard session.

MCP servers

The MCP-server directory (9,000+ entries, official + community). Same list contract and write rules as skills; the catalog-specific fields:

GEThttps://api.airforce/v1/mcp-servers?search=github

GEThttps://api.airforce/v1/mcp-servers/:id

POSThttps://api.airforce/v1/mcp-servers/:id/like — session auth

Parameter	Type	Required	Description
url	string	Optional	The MCP endpoint clients connect to.
transport	string	Optional	Transport label: "Streamable HTTP", "SSE" or "stdio".
tools	array	Optional	Advertised tool names (informational).
homepage	string	Optional	Optional repo / docs link.

This directory lists third-party MCP servers. Airforce’s own MCP server (models, images, balance as tools, billed to your key) has its own guide under /docs/mcp.

Marketplaces

Curated collections that bundle skills and MCP servers into one installable set. Same list contract; each item carries an items array of references that are resolved at read time:

GEThttps://api.airforce/v1/marketplaces?search=devops

GEThttps://api.airforce/v1/marketplaces/:id

POSThttps://api.airforce/v1/marketplaces/:id/like — session auth

{
  "id": "mp_91c0…",
  "name": "Full-stack DevOps pack",
  "description": "CI review, commit hygiene and a GitHub MCP server in one bundle.",
  "homepage": "https://github.com/…",
  "items": [
    { "kind": "skill", "id": "sk_4f2a…" },
    { "kind": "mcp_server", "id": "mcp_77b1…" }
  ],
  "tags": ["devops"], "likes": 96
}

Characters & plugins

Two further public catalogs follow the same pattern:

Parameter	Type	Required	Description
GET /v1/characters	endpoint	Optional	Community character cards for roleplay clients. Filters: ?search= and ?tags= (no pagination). GET /v1/characters/:id for one card, POST …/:id/like and …/:id/interact (session auth) for stats, GET /v1/tags for the tag cloud.
GET /v1/plugins	endpoint	Optional	Community plugin registry. Filters: ?search= and ?section=. GET /v1/plugins/verified lists curated entries only; GET /v1/plugins/download/:file_name serves the artifact.

Prefer a browseable view?

The same data powers the Skills, MCP and Marketplaces directory pages with search, tags and one-command install snippets.