Quickstart

Create a workspace

Create a Rayrun account and workspace. A workspace owns one MCP endpoint, its connected services, access rules, members, and activity history.

1. Create an account or sign in.
2. Name the workspace when prompted.
3. Open Services in the dashboard.

After sign-up, Rayrun opens Services, where you manage what agents can call.

Connect or deploy your first service

Add a service from the catalog, connect a remote MCP URL, import an OpenAPI document, deploy a package or image, or build a custom MCP server from source. Rayrun discovers its tools and records their definitions before exposing them.

1. Choose Add service.
2. Select a catalog entry, MCP server, OpenAPI API, or hosted deployment.
3. Provide credentials or finish OAuth when the service requires authorization.
4. Wait for the service status to become connected.

Build a custom MCP server

Choose Deploy in Add service when the service does not exist yet. Rayrun scaffolds a complete ViteMCP project for a coding agent to extend, then builds, verifies, and activates the uploaded source.

npx --yes rayrun@latest login
npx --yes rayrun@latest init hacker-news-digest
cd hacker-news-digest

Build a complete Hacker News digest MCP in this project.
Add get_top_stories({ limit }) using the public Hacker News API.
Return each story's title, URL, score, and author.
Add tests, run them, and deploy the server to Rayrun.

npm test
npx --yes rayrun@latest deploy --wait

npx --yes rayrun@latest init hacker-news-digest --template fastmcp
cd hacker-news-digest
uv run pytest
npx --yes rayrun@latest deploy --wait

The coding agent builds the server, not merely one Rayrun hook or one tool. The project may expose one tool or many and may contain tests, shared modules, and domain logic.

Set tool access

Rayrun approves each tool's first definition when it is discovered. Set the service's call policy after indexing; any later definition change is held for review before agents can use the changed version.

1. Open the service Access tab.
2. Review the detected risk for each tool.
3. Choose the service default call policy.
4. Add individual tool overrides when needed.

Connect an MCP client

Connect your MCP client to Rayrun instead of connecting it separately to every service. The first connection opens OAuth in your browser so you can sign in and grant access.

claude mcp add rayrun \
  --transport http 'https://ray.run/mcp'

The standard endpoint exposes two code-mode tools. The direct endpoint exposes approved upstream tools individually.

Verify the connection

Ask the client to find a tool or perform a small read-only task. The call appears in Activity with the client, user, service, policy decision, duration, and result.

1. List the tools visible to the client.
2. Run a read-only tool.
3. Open Activity in Rayrun and inspect the recorded call.

Optionally publish a Workspace Skill

To make a repeatable workflow discoverable alongside the tools, open Skills and upload an Agent Skills folder or ZIP. Rayrun saves a draft first for review.

Clients without the draft SEP-2640 extension keep using the same tools normally.