Raworc

You run a production-ready MCP server for Raworc to let AI assistants interact with Raworc’s agent runtime platform. This server exposes Raworc capabilities via the MCP protocol, enabling seamless, structured communication and control over spaces, sessions, agents, secrets, builds, and real-time agent interactions.

How to use

You integrate the MCP server with your preferred MCP client (for example Claude Desktop) and start the server using the provided runtime command. Once running, you can query health, version, and a comprehensive set of API endpoints through the MCP protocol. Use the client to perform actions such as creating spaces, managing sessions, deploying agents, handling messages, and monitoring builds in real time. Ensure your client is configured with the proper environment variables and the correct default space to simplify workflows.

How to install

Prerequisites include Rust 1.70 or higher and Node.js 16.0 or higher if you plan to install via npx. You also need a Raworc account and network access to api.remoteagent.com.

# Option 1: Install via npx (recommended)
# Test the installation
npx @raworc/mcp-server --help

# Use directly with Claude Desktop
npx @raworc/mcp-server

# Option 2: Build from source

# Install Rust and Node.js beforehand

# Clone the repository
git clone https://github.com/harshapalnati/raworc-mcpserver.git
cd raworc-mcpserver

# Build the project
cargo build --release

# Test the installation
./target/release/raworc-mcp --help

If you prefer to run locally after building from source, start commands shown below demonstrate how you would test the built binary directly.

Configuration and usage details

Environment variables you can configure for the MCP server are listed here. These are used by the server to connect to Raworc and to control runtime behavior.

# Environment variables
export RAWORC_API_URL="https://api.remoteagent.com/api/v0"
export RAWORC_AUTH_TOKEN="your-jwt-token"
export RAWORC_DEFAULT_SPACE="your-space"
export RAWORC_TIMEOUT="30"
export LOG_LEVEL="info"

Notes on authentication

Obtain an authentication token by authenticating against the Raworc API. Use the resulting Bearer token in your client configuration to authorize MCP requests.

Claude Desktop integration example

Configure Claude Desktop to load the MCP server via npx with the necessary environment variables.

Troubleshooting

Common issues include authentication failures, connectivity problems to api.remoteagent.com, or permission errors. Verify that your token is valid and has the required scope, ensure network access to the Raworc API, and confirm you’re operating within the correct space.

Development notes

Builds and tests can be run from source. If you modify the server, rebuild with cargo build --release and run tests with cargo test. When distributing via npm for npx usage, ensure you run npm install before attempting npm scripts.

Examples and quick-start hints

A quick-start flow is to install via npx, test --help to confirm the server is available, and then configure your MCP client with the provided environment variables. If you build from source, the final start command is the compiled binary at ./target/release/raworc-mcp.

Available tools

health_check

Check Raworc API health status.

get_version

Get Raworc API version information.

list_service_accounts

List all service accounts.

create_service_account

Create a new service account.

get_service_account

Get a specific service account by ID.

update_service_account

Update a service account.

delete_service_account

Delete a service account.

update_service_account_password

Update service account password.

list_roles

List all RBAC roles.

create_role

Create a new role with defined rules.

get_role

Get a specific role by ID.

delete_role

Delete a role.

list_role_bindings

List all role bindings.

create_role_binding

Create a new role binding.

get_role_binding

Get a specific role binding by ID.

delete_role_binding

Delete a role binding.

list_spaces

List all spaces.

create_space

Create a new space.

get_space

Get a specific space by name.

update_space

Update a space.

delete_space

Delete a space.

list_sessions

List all sessions in a space.

create_session

Create a new session.

get_session

Get session details by ID.

update_session

Update session details.

update_session_state

Update session state.

close_session

Close a session.

restore_session

Restore a closed session.

remix_session

Fork a session.

pause_session

Pause a session.

resume_session

Resume a paused session.

terminate_session

Terminate a session.

get_messages

Get messages from a session.

send_message

Send a message to a session.

get_message_count

Get message count for a session.

clear_messages

Clear all messages from a session.

list_agents

List agents in a space.

create_agent

Create a new agent.

get_agent

Get a specific agent.

update_agent

Update an agent.

delete_agent

Delete an agent.

update_agent_status

Update agent status.

deploy_agent

Deploy an agent.

stop_agent

Stop an agent.

list_running_agents

List running agents in a space.

get_agent_logs

Get logs for a specific agent.

list_secrets

List secrets in a space.

create_secret

Create a new secret.

get_secret

Get a specific secret.

update_secret

Update a secret.

delete_secret

Delete a secret.

create_build

Trigger a space build.

get_latest_build

Get latest build status.

get_build

Get specific build status.