Getting started with Agently
Everything you buy on Agently plugs into the AI tools you already use — Claude, Cursor, ChatGPT, or any MCP-compatible client. This guide walks you through both product types, from purchase to first call.
1. Using hosted skills (MCP)
A hosted skill is a running server that adds new tools to your AI client. After purchase you get two things: an endpoint URL and a license key. Register them once, and your agent can call the skill's tools automatically.
Buy a plan
On the skill page, pick a plan and click Buy now (or Get for free for free tiers). Paid plans go through Stripe Checkout.
Copy your license key
Your key (starts with agy_) is shown exactly once right after purchase. Copy it somewhere safe — you can always rotate to a new key from the dashboard, but the old one stops working immediately.
Register the skill in your client
Each skill's endpoint is shown on its page and in your dashboard's Connect instructions. Use one of the setups below, replacing the endpoint and YOUR_LICENSE_KEY:
Claude Code (CLI)
claude mcp add my-skill https://agently.tokyocorp.net/mcp/<skill-slug> \ --transport http \ --header "Authorization: Bearer YOUR_LICENSE_KEY"
Claude Desktop / Claude.ai (custom connector, OAuth)
Settings → Connectors → Add custom connector and paste the endpoint URL — no headers needed. On first use Claude opens Agently's authorization page; paste your license key once and the connection is saved.
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"my-skill": {
"url": "https://agently.tokyocorp.net/mcp/<skill-slug>",
"headers": {
"Authorization": "Bearer YOUR_LICENSE_KEY"
}
}
}
}ChatGPT (developer mode, OAuth)
Settings → Connectors → Advanced → Developer mode, then add the endpoint as a new connector. ChatGPT signs in via Agently's authorization page the same way (paste your license key once).
Call it
Ask your agent something the skill is good at — e.g. "Use search_web to research MCP marketplaces". The tools appear automatically in the client's tool list. Usage shows up in your dashboard within seconds.
2. Using skill packages (SKILL.md)
A skill package is a downloadable bundle (SKILL.md plus supporting files) that teaches Claude a repeatable workflow. It runs inside Claude — no server or license key needed at runtime.
Buy and download
After purchase, open your dashboard and click Download on the license. You'll get a versioned .zip bundle.
Install it
Claude.ai: Settings → Capabilities → Skills → Upload skill, and select the zip. Claude Code: unzip into .claude/skills/ inside your project (or ~/.claude/skills/ for all projects).
Use it
Just describe the task — Claude activates the skill when relevant, or you can name it explicitly (e.g. "Review this NDA with the contract-review skill").
3. Managing license keys
Keys are shown once at issue time and stored only as a hash. From the dashboard you can rotate a key (the old one is invalidated instantly) and watch per-period usage. One license covers one skill — your other licenses keep their own keys.
4. How billing works
Only successful tool calls are metered — failed calls, timeouts, and protocol overhead are never billed. Free tiers reset monthly. Per-call plans bill your saved card monthly for actual usage; subscription plans include a fixed quota. Manage cards and invoices anytime via Manage billing on the dashboard.
5. Troubleshooting
401Missing license key — the Authorization header isn't reaching us. Check the header format: Authorization: Bearer agy_...403License rejected — the key was rotated, the subscription lapsed, or the listing is unavailable. Check the license status in your dashboard.429Quota exceeded — you've used this month's included calls. Upgrade the plan or wait for the monthly reset.502Upstream unreachable — the creator's server is down. Metering never counts these; try again later or contact the creator via the listing page.