Before you call a tool
Connect the client
A local server over stdio, started with npx on macOS, Windows or Linux with Node.js 22 or newer. Sign-ins are kept in the system keychain (a file readable only by you on Linux without one). The setup page shows how to add it; it is not a remote MCP endpoint.
Account and authorization
One scope, skills:read. A browser approval lasts 7 days and is not renewed on its own. The CLI and the MCP server share it, and disconnecting revokes it for both.
Searching and reading a Skill need no account. Everything that downloads, installs or updates checks access live on the server, so the agent can ask first with get_skill_access without spending a download.
Nothing a tool fetches is run. Installed Skills are read by your agent like any other folder, and catalog text and package files are treated as untrusted data.
In the examples, <skill-slug> stands for a Skill’s name as search_skills returns it and <published-version> for the version get_skill or check_updates reports.
Discovery
01 / 03search_skills
PublicFinds Skills by the result you want, with the filters you state. No account needed.
Parameters 9
querystringOptionalmaxLength 200Default ""What you want made, in your own words.outputTypestringOptionalOne of: html, image, video, presentation, game, otherThe kind of result, when it is clear: a web page, an image, a video, a deck, a game.deliveryScopestringOptionalOne of: complete, componentcomplete for a finished piece, component for a part you build into something else.avoidVoiceoverbooleanOptionaltrue to skip Skills that add narration.allowApiKeysbooleanOptionalfalse to skip Skills that need a third-party API key.allowExternalCostsbooleanOptionalfalse to skip Skills with outside model or render costs.limitintegerOptionalmin 1max 20Default 5How many results to return.offsetintegerOptionalmin 0max 10000Default 0Where the next page starts; pass the nextOffset of the last reply.localestringOptionalOne of: en, zh-CN, zh-TW, ja, ko, es, pt-BR, de, frDefault "en"The language of the Skill texts.
{
"query": "product launch video",
"outputType": "video",
"allowApiKeys": false,
"limit": 5
}Result and behavior
A list of Skills with their preview links, versions, inputs, dependencies and cost notes, plus nextOffset when there are more. A filter the server could not confirm is reported as unconfirmed, so the agent checks it before relying on it. Searching never grants access.
get_skill
PublicShows one Skill before you install it.
Parameters 1
slugstringRequiredminLength 1maxLength 64The Skill's name in its address, as search_skills returns it.
{
"slug": "<skill-slug>"
}Result and behavior
The preview page, the published version, what the Skill needs from you, its dependencies, any outside costs and what it delivers. Reading it does not unlock the package.
Account and authorization
02 / 03connect_account
Browser authorization flowStarts the browser sign-in and returns a link and a short code at once.
Parameters 0
None. Pass an empty object, {}.
{}Result and behavior
A verification link, a code and pollAfterSeconds. The agent shows you the link and the code; you approve in the browser. Calling it again while a sign-in is pending returns the same one.
connection_status
Browser authorization flowChecks a pending sign-in without waiting inside the call.
Parameters 0
None. Pass an empty object, {}.
{}Result and behavior
pending, denied, expired or connected. Once connected it adds the plan and when the sign-in ends. It never returns a token.
account_status
Account requiredYour plan, when the sign-in ends and today's download allowance.
Parameters 0
None. Pass an empty object, {}.
{}Result and behavior
The plan (free or premium), the scope, the expiry time, and today's limit, used and remaining downloads with the reset time. No name, email or token.
disconnect_account
Account requiredSigns this computer out.
Parameters 0
None. Pass an empty object, {}.
{}Result and behavior
Cancels a pending sign-in, revokes the sign-in on the server and deletes it from this computer. The terminal commands share it, so they are signed out too. Says whether the server confirmed the revocation.
get_skill_access
Account requiredTells you whether your account can download one Skill, before it does.
Parameters 1
slugstringRequiredminLength 1maxLength 64The Skill to check.
{
"slug": "<skill-slug>"
}Result and behavior
Free, included in your plan, bought, or needs a purchase, with canDownload, the purchase link when one is needed and today's allowance. It uses no download; the download checks everything again.
Downloads, installation and updates
03 / 03download_skill
Account requiredChanges local filesSaves a Skill's checked ZIP into a folder without installing it.
Parameters 3
slugstringRequiredminLength 1maxLength 64The Skill to download.downloadDirectorystringRequiredmaxLength 4096Absolute path of the folder for the ZIP; it is created if needed.expectedVersionstringOptionalminLength 1maxLength 64The version you picked. If the published one changed since, nothing is saved.
{
"slug": "<skill-slug>",
"downloadDirectory": "/Users/you/Downloads",
"expectedVersion": "<published-version>"
}Result and behavior
The path of the new ZIP and its version. Access and the daily allowance are checked live; an existing file is never overwritten.
install_skill
Account requiredChanges local filesDownloads the published version and installs it into the agent folder you choose.
Parameters 5
slugstringRequiredminLength 1maxLength 64The Skill to install.agentstringRequiredOne of: shared, codex, cursor, gemini-cli, opencode, claude-code, kimi-code, antigravityWhich agent's Skills folder to use. shared is the folder Codex, Cursor and most others read; claude-code and antigravity have their own.scopestringOptionalOne of: global, projectDefault "global"global for the folder in your home directory; project for one repository.projectDirectorystringOptionalmaxLength 4096With scope project: the repository's absolute path. Leave it out for global.expectedVersionstringOptionalminLength 1maxLength 64The version you picked; the install stops if the published one changed.
{
"slug": "<skill-slug>",
"agent": "claude-code",
"scope": "global"
}Result and behavior
The folder it went into, the version and the path of SKILL.md. Nothing from the Skill runs. A Skill that is already there is left alone; a paid Skill your account lacks returns its price and purchase link instead.
list_installed_skills
Local filesLists the Skills in one global or project folder.
Parameters 3
agentstringRequiredOne of: shared, codex, cursor, gemini-cli, opencode, claude-code, kimi-code, antigravityWhich agent's Skills folder to use. shared is the folder Codex, Cursor and most others read; claude-code and antigravity have their own.scopestringOptionalOne of: global, projectDefault "global"global for the folder in your home directory; project for one repository.projectDirectorystringOptionalmaxLength 4096With scope project: the repository's absolute path. Leave it out for global.
{
"agent": "shared",
"scope": "global"
}Result and behavior
Each Skill's name and folder. Skills this server installed carry their version; others are marked unmanaged. It reads metadata only.
check_updates
Local filesCompares the Skills this server installed with their published versions.
Parameters 5
agentstringRequiredOne of: shared, codex, cursor, gemini-cli, opencode, claude-code, kimi-code, antigravityWhich agent's Skills folder to use. shared is the folder Codex, Cursor and most others read; claude-code and antigravity have their own.scopestringOptionalOne of: global, projectDefault "global"global for the folder in your home directory; project for one repository.projectDirectorystringOptionalmaxLength 4096With scope project: the repository's absolute path. Leave it out for global.offsetintegerOptionalmin 0max 9007199254740991Default 0Where the next page starts; pass the nextOffset of the last reply.limitintegerOptionalmin 1max 5Default 5How many Skills to check at once.
{
"agent": "claude-code",
"scope": "global",
"limit": 5
}Result and behavior
current, update_available (with publishedVersion), unavailable or unmanaged for each Skill, five at a time. It downloads nothing and uses no allowance.
update_skill
Account requiredChanges local filesUpgrades a Skill this server installed, after you approve the version.
Parameters 5
agentstringRequiredOne of: shared, codex, cursor, gemini-cli, opencode, claude-code, kimi-code, antigravityWhich agent's Skills folder to use. shared is the folder Codex, Cursor and most others read; claude-code and antigravity have their own.scopestringOptionalOne of: global, projectDefault "global"global for the folder in your home directory; project for one repository.projectDirectorystringOptionalmaxLength 4096With scope project: the repository's absolute path. Leave it out for global.slugstringRequiredminLength 1maxLength 64The Skill to update.expectedVersionstringRequiredminLength 1maxLength 64The published version you approved, from check_updates or get_skill.
{
"slug": "<skill-slug>",
"agent": "claude-code",
"scope": "global",
"expectedVersion": "<published-version>"
}Result and behavior
The new version and backupPath, where the whole previous folder (your edits included) is kept. Only Skills this server installed can be updated here.
Installation directories
install_skill, list_installed_skills, check_updates and update_skill work in one folder, picked by agent and scope. With scope: global the folder is under your home directory; scope: project needs projectDirectory and supports the shared and Claude Code layouts.
| agent | global | project |
|---|---|---|
| shared | ~/.agents/skills | <project>/.agents/skills |
| codex | ~/.agents/skills | — |
| cursor | ~/.agents/skills | — |
| gemini-cli | ~/.agents/skills | — |
| opencode | ~/.agents/skills | — |
| claude-code | ~/.claude/skills | <project>/.claude/skills |
| kimi-code | ~/.agents/skills | — |
| antigravity | ~/.gemini/config/skills | — |
{
"slug": "<skill-slug>",
"agent": "claude-code",
"scope": "project",
"projectDirectory": "/Users/you/code/launch-site"
}Status and recovery
- 1Not connected, or the sign-in expiredThe reply names connect_account as the next tool. Approve the new sign-in in the browser, then retry the same call.
- 2The folder already existsinstall_skill never replaces a Skill (there is no force here). Use list_installed_skills and check_updates, then update_skill once you approve a version.
- 3A purchase is needed, or today's allowance is used upThe reply carries the price and the purchase link, or the reset time. Downloading the same Skill again on the same day does not count twice.
- 4The agent cannot see the toolsRestart the client or open a new session, then follow the client's guide to check the server is listed and running.