Prerequisites
- Raycast for macOS (Pro plan required for AI) — raycast.com
- Node.js 18+
- Agent MCP Studio at agentmcp.studio
Step-by-Step Setup
Get your relay URL and download bridge.js
Open the studio → Settings → MCP Relay Bridge → copy URL → click Connect. Then:
curl -O https://agentmcp.studio/bridge.js && npm install ws
-
Open Raycast Settings → Extensions → AI → MCP
In Raycast: ⌘, → Extensions → AI → scroll to Model Context Protocol → click Add MCP Server.
-
Add the server configuration
{ "agent-mcp-studio": { "command": "node", "args": [ "/Users/you/mcp/bridge.js", "wss://agentmcp.studio/api/relay/YOUR-UUID" ] } }Save. Raycast will launch bridge.js when the MCP extension is used.
Invoke tools from Raycast AI
Open Raycast (⌥Space), type AI, and start a conversation. Ask Raycast to use one of your tools: "Use my fetch_webpage tool to check the status of example.com." Raycast AI will call bridge.js and relay the tool call to your browser.
Raycast is currently macOS-only. For Windows/Linux productivity launchers, consider using the tools via Claude Desktop or a browser-based interface instead.
Frequently Asked Questions
Yes — Raycast's AI features support MCP via the Raycast MCP extension (available in the Raycast Store). Once installed and configured, your Agent MCP Studio tools are available in Raycast AI commands and the AI chat interface.
Raycast is a macOS launcher and productivity tool with built-in AI features. With MCP, you can call custom tools (built in Agent MCP Studio) directly from Raycast's command palette and AI chat — making your browser tools accessible app-wide on your Mac.
Raycast is macOS-only. For similar functionality on Windows or Linux, consider using Cursor, Cline, or LangChain integrations to access your Agent MCP Studio tools from the command line or code editor.
Raycast AI features (including MCP tool access) require a Raycast Pro subscription. The Raycast app itself is free, but AI and advanced extension features are Pro-only.
Yes — once configured, Agent MCP Studio tools are available in all Raycast AI surfaces: Quick AI (Raycast's floating AI bar), AI Commands, and the full AI Chat window. The AI decides when to invoke tools based on your query.