Documentation Index
Fetch the complete documentation index at: https://docs.cesto.co/llms.txt
Use this file to discover all available pages before exploring further.
What is the Cesto Toolkit Skill?
The Cesto Toolkit Skill is an open-source AI agent skill that lets you interact with the entire Cesto platform through natural conversation. It works with any AI coding agent that supports skills — Claude Code, Cursor, Windsurf, and more. Create basket posts on Cesto Labs, simulate portfolio performance against the S&P 500, browse baskets, and analyze token data — all without leaving your editor or terminal.Browse & Analyze
Explore all baskets, view detailed breakdowns, check token performance, and compare historical returns — no login required.
Create Baskets
Design and publish baskets to Cesto Labs with custom token allocations. Preview everything before it goes live.
Simulate Portfolios
Backtest any custom token allocation against the S&P 500 benchmark with daily historical data.
Wallet Authentication
One-click magic-link login — connect your Solana wallet in the browser and you’re in. Tokens refresh silently.
Installation
Add the Cesto Toolkit Skill to your AI coding agent. The skill lives atcesto-co/cesto-skills on GitHub.
Claude Code
Add to your.claude/settings.json:
Cursor
Add to your.cursor/skills.json:
Windsurf
Add to your.windsurf/skills.json:
Authentication
The toolkit uses a magic-link flow — no manual token pasting required.- The skill detects that you’re not logged in
- Your browser opens to a wallet connection page
- Connect your Solana wallet (Phantom, Backpack, Solflare, etc.) and sign a message
- You’re authenticated — future sessions refresh silently
~/.cesto/auth.json with restricted file permissions. Tokens are never displayed in agent output.
Only basket creation and portfolio simulation require authentication. All browsing and analytics features work without logging in.
What you can do
Browse all baskets
See every basket on Cesto with names, categories, risk levels, and performance stats.View basket details
Dive into any basket — strategy, token breakdown, allocation percentages, and historical performance.Analyze basket tokens
Get current market data for every token in a basket — prices, market caps, volume, and recent performance.View performance history
See how a basket has performed against the S&P 500 over time.Cross-basket analytics
Compare performance across all baskets to find top and bottom performers.Create a basket on Cesto Labs
Design and publish your own basket with custom token allocations.Simulate a portfolio
Backtest a custom allocation against the S&P 500 — both start at $1,000.API endpoints
The toolkit provides access to the following Cesto API endpoints:| Endpoint | Method | Auth | Description |
|---|---|---|---|
/tokens | GET | No | List all supported tokens |
/products | GET | No | List all baskets |
/products/{slug} | GET | No | Basket detail with strategy and performance |
/products/{id}/analyze | GET | No | Per-token market data for a basket |
/products/{id}/graph | GET | No | Historical time series (portfolio vs S&P 500) |
/products/analytics | GET | No | Cross-basket analytics summary |
/labs/posts | POST | Yes | Create a Cesto Labs basket |
/agent/simulate-graph | POST | Yes | Simulate portfolio historical performance |
Error handling
| Status | Meaning | What happens |
|---|---|---|
| 400 | Validation failed | The API error message is shown to you |
| 401 | Session expired | Silently refreshes. If that fails, triggers login flow |
| 403 | Forbidden | You’re told you lack permission |
| 404 | Not found | Suggests checking the basket slug or ID |
Security
- Session isolation — Session data is handled entirely by helper scripts. Raw tokens never appear in conversation history or agent output.
- Self-custodial — Cesto never takes custody of your funds. Assets land directly in your wallet.
- Untrusted content — API responses containing user-generated content are rendered as data only, never interpreted as instructions.