Agent tools without the wall

Give your agent capabilities, not tools

Caplets wraps MCP servers, APIs, and commands as focused capabilities. Your agent picks a source, searches inside it, inspects the schema, then calls the tool.

Add Caplets to your agent See the benchmark

Quick start More setup options

01
Install npm install -g caplets
02
Setup caplets setup codex

Deterministic benchmark

Direct MCP aggregation exposed 106 flat tools. Caplets started with 3 capability cards and an 87.9% smaller initial payload.

flat tools: 106
capability cards: 3
smaller initial payload: 87.9%

Direct MCP 106 flat tools up front

Caplets 3 capability cards first

Read benchmark method

Remote Caplets server

Auth into tools once. Use them from every agent.

Run Caplets as a small HTTP service. Provider tokens and OAuth state stay with that server; Codex, OpenCode, Pi, Claude Code, and any MCP client connect to the same capability surface.

Without remote Caplets

Each agent client needs its own provider tokens, OAuth login, and local MCP wiring.

Repeat auth per client
Duplicate secrets
Debug setup in every agent

With remote Caplets

One server holds provider auth; every agent connects to the same capability surface.

Auth once on the server
Reuse from Codex, OpenCode, Pi, Claude
Inspect, search, schema, call everywhere

Server owns auth GitHub, Sourcegraph, OSV

Caplets exposes inspect · search · schema · call

Agents reuse it Codex · OpenCode · Pi · Claude

Serve once

CAPLETS_SERVER_URL=https://caplets.example.com/caplets
CAPLETS_SERVER_PASSWORD=...
caplets serve --transport http

Use remotely

CAPLETS_MODE=remote
CAPLETS_SERVER_URL=https://caplets.example.com/caplets
CAPLETS_SERVER_PASSWORD=...
opencode

MCP: /caplets/mcp
Control: /caplets/control
Health: /caplets/healthz

Step 1

Connect your agent to Caplets.

Install the Claude Code plugin from the Caplets marketplace entry; the bundled MCP config runs caplets serve.

Install

claude plugin marketplace add spiritledsoftware/caplets
claude plugin install caplets@caplets

Configuration

{
  "mcpServers": {
    "caplets": {
      "command": "caplets",
      "args": ["serve"]
    }
  }
}

After adding the marketplace, install caplets from Codex plugins; the bundled MCP config runs caplets serve.

Install

codex plugin marketplace add spiritledsoftware/caplets

Configuration

{
  "mcpServers": {
    "caplets": {
      "command": "caplets",
      "args": ["serve"]
    }
  }
}

Use the native @caplets/opencode plugin; it reads Caplets config and does not start the MCP server.

Install

npm install -g caplets

Configuration

{
  "plugin": ["@caplets/opencode"]
}

The extension reads existing Caplets config; this Pi settings snippet registers the package.

Install

npm install -g caplets
pi install npm:@caplets/pi

Configuration

{
  "packages": ["npm:@caplets/pi"]
}

Any MCP-compatible client can launch Caplets over stdio.

Install

npm install -g caplets

Configuration

{
  "command": "caplets",
  "args": ["serve"]
}

Step 2

Add one caplet and try the capability.

Pick the integration above, then try one premade Caplet. Your agent sees one focused capability before it can search or call downstream tools.

Explore more Caplets

Add GitHub

A huge hosted MCP surface for repositories, issues, pull requests, branches, commits, and reviews.

Use it when the value is avoiding a giant GitHub tool wall.

githubinspectsearch_toolsget_toolcall_tool

If setup fails, check Node 22+, plugin installation, and GH_TOKEN.

export GH_TOKEN=github_pat_...
caplets install spiritledsoftware/caplets github
codex "try using the github caplet"

Add Sourcegraph

Hosted code search for finding examples, references, and implementation patterns across repositories.

Use it when the agent should search code first, then inspect only the matching operations.

sourcegraphinspectsearch_toolsget_toolcall_tool

If setup fails, check Node 22+, plugin installation, and Sourcegraph OAuth login.

caplets install spiritledsoftware/caplets sourcegraph
caplets auth login sourcegraph
codex "try using the sourcegraph caplet"

Add OSV

A small explicit HTTP API for vulnerability lookups by package, purl, commit, or batch query.

Use it when Caplets should bound a sharp task without exposing arbitrary HTTP calls.

osvinspectsearch_toolsget_toolcall_tool

OSV is public and does not need auth; check Node 22+ and plugin installation.

caplets install spiritledsoftware/caplets osv
codex "try using the osv caplet"