Raycast Bridges
Connect any REST API, MCP server, or CLI tool to Raycast AI
Raycast Bridges makes Raycast AI extensible: connect any REST API, MCP server, or shell CLI, describe it in plain English, and an agent (Claude) searches for real docs, writes a config and a guide, then prompts you for credentials. The result is a callable tool the AI can use in any future conversation.
Capability Types
| Type | What it does | Examples |
|---|---|---|
| API Source | Authenticated REST API calls | Craft API, GitHub API, Stripe |
| MCP Server | Model Context Protocol servers (stdio or remote) | GitHub MCP, Craft MCP |
| CLI Tool | Shell CLI execution (30s timeout, 50KB output) | gh, vercel, kubectl, yt-dlp |
| Skill | AI instructions referencing other capabilities | “Review my daily notes” |
How it works
- Add Capability — describe an API, MCP server, CLI tool, or skill in plain English. An agent searches the web for real docs, writes a config and a guide, then prompts you for credentials if needed.
- Use it — ask Raycast AI anything that involves that capability. It discovers capabilities via keyword search, reads the guide once, then makes authenticated requests or executes commands on your behalf.
- Manage — edit configs, rotate credentials, disable or remove capabilities from the Manage Capabilities command.
Prerequisites
- Raycast with AI enabled
- Claude CLI installed (used by the scaffolding agent)
- A Claude account (Max or Pro) or an Anthropic API key
AI Tools
Four tools are registered in Raycast AI, used automatically in conversations:
| Tool | Purpose |
|---|---|
search-capabilities | Keyword search across names, descriptions, and guides. Called first. |
list-capabilities | Lists all installed capabilities. Fallback when search returns nothing. |
get-capability-guide | Loads full documentation for a capability. Called once per conversation. |
call-capability | Executes: REST API calls, MCP pseudo-paths, or CLI commands. |
Privacy
Everything runs locally. Credentials stay in ~/.bridges/ on your machine.
No proxy, no middleman.
Open source
Raycast Bridges is open source. Inspired by Craft Agents.