rp1-dev-mcp

2 stars TypeScriptOthers Updated Mar 19, 2026

Documentation

rp1-dev-mcp

MCP server for the RP1 spatial internet developer workflow — create spatial fabrics, attach to RP1's universal spatial fabric, manage servers, and configure Network Service Objects (NSOs).

This is the infrastructure layer for building on RP1. For content editing (scenes, objects, 3D models), use ManifolderMCP.

What is RP1?

RP1 is the open spatial internet platform — a metaverse browser and ecosystem for building, connecting, and traversing real-time 3D experiences. Developers can self-host spatial servers, create persistent 3D environments (spatial fabrics), and attach them to RP1's universal spatial fabric to make them discoverable by anyone.

Tools

Server Management (4)

Tool	Purpose
`list_profiles`	List configured connection profiles
`server_status`	Check server health, version, and capabilities
`server_config`	View server configuration
`server_logs`	Retrieve recent server logs

Fabric Lifecycle (6)

Tool	Purpose
`create_fabric`	Create a new spatial fabric (persistent 3D environment)
`list_fabrics`	List all fabrics on a server
`get_fabric`	Get fabric details, config, and attachment state
`configure_fabric`	Update fabric settings
`delete_fabric`	Remove a fabric
`export_fabric`	Export as MSF file

Attach / Detach (5)

Tool	Purpose
`attach_fabric`	Attach fabric to RP1's universal spatial fabric
`detach_fabric`	Disconnect from the universal fabric
`attachment_status`	Check attachment state and location
`list_attachments`	List all your attachment points
`move_attachment`	Relocate an attachment

Network Service Objects (5)

Tool	Purpose
`create_nso`	Create an NSO (AI, payments, IoT, multiplayer, etc.)
`list_nsos`	List NSOs in a fabric
`get_nso`	Get NSO details and endpoint info
`update_nso`	Update NSO configuration
`delete_nso`	Remove an NSO

Developer Workflow (5)

Tool	Purpose
`scaffold_project`	Generate project from templates
`validate_fabric`	Validate config before deployment
`deploy_fabric`	Deploy fabric to server
`get_dev_info`	Developer account info
`generate_nso_template`	Generate NSO boilerplate

Monitoring (3)

Tool	Purpose
`ping`	Quick connectivity check
`fabric_health`	Detailed health check
`list_connected_users`	See who's connected

Setup

Prerequisites

Node.js >= 18
An RP1 developer account (dev.rp1.com)

Install

bash

git clone https://github.com/jl-codes/rp1-dev-mcp.git
cd rp1-dev-mcp
npm install
npm run build

Configure

Create `~/.config/rp1-dev-mcp/config.json`:

json

{
  "default": {
    "serverUrl": "https://your-server.example.com",
    "devApiUrl": "https://dev.rp1.com",
    "apiKey": "your-api-key",
    "fabricUrl": "https://your-server.example.com/fabric/fabric.msf"
  }
}

Field	Description
`serverUrl`	Required. URL of your RP1 spatial fabric server
`devApiUrl`	RP1 developer API URL (default: `https://dev.rp1.com`)
`apiKey`	API key for authentication
`fabricUrl`	Your fabric's MSF URL

Multiple profiles can be defined (e.g., `"default"`, `"staging"`, `"production"`) and selected per-call via the `profile` parameter.

Add to MCP Client

Build first (`npm run build`), then register:

Cline (VS Code):

Add to your MCP settings:

json

{
  "mcpServers": {
    "rp1-dev": {
      "command": "node",
      "args": ["/absolute/path/to/rp1-dev-mcp/dist/index.js"]
    }
  }
}

Claude Code:

bash

claude mcp add --scope user rp1-dev -- node /absolute/path/to/rp1-dev-mcp/dist/index.js

Codex:

bash

codex mcp add rp1-dev -- node /absolute/path/to/rp1-dev-mcp/dist/index.js

Gemini CLI:

bash

gemini mcp add -s user rp1-dev node /absolute/path/to/rp1-dev-mcp/dist/index.js

Usage Examples

code

> List my RP1 connection profiles
> Check server status
> Create a standalone spatial fabric called "My World"
> Attach it to RP1's universal spatial fabric
> Create an AI agent NSO in my fabric
> Scaffold a new full-stack RP1 project
> Generate a commerce NSO template

MCP Resources

The server exposes these resources for AI agents:

URI	Description
`rp1://dev-guide`	Developer workflow documentation
`rp1://fabric-schema`	Fabric configuration JSON schema
`rp1://nso-schema`	NSO definition JSON schema
`rp1://object-types`	Object type hierarchy reference

**ManifolderMCP** — MCP server for editing spatial fabric scenes (objects, resources, actions)
**Manifolder** — Web-based visual map explorer
**RP1 Developer Center** — Register and get started building on RP1

Development

bash

npm run dev          # TypeScript watch mode
npm run build        # Build for production
npm run inspect      # Test with MCP Inspector

Project Structure

code

src/
  index.ts              # MCP server entry point
  config.ts             # Connection profile loader
  types.ts              # Shared TypeScript types
  output.ts             # Pagination helpers
  agent-guide.md        # Workflow docs served to MCP clients
  client/
    rp1-client.ts       # RP1 developer API client
  tools/
    index.ts            # Tool registry
    schemas.ts          # Zod input schemas
    errors.ts           # Error serialization
    server.ts           # Server management tools
    fabric.ts           # Fabric CRUD tools
    attach.ts           # Attach/detach tools
    nso.ts              # NSO management tools
    scaffold.ts         # Scaffolding & workflow tools
    monitoring.ts       # Health & monitoring tools

License

Licensed under the Apache License, Version 2.0. See LICENSE.

Contributing

Contributions are welcome! By submitting a pull request, you agree that your contribution will be licensed under the Apache License, Version 2.0.

Frequently asked questions

What is rp1-dev-mcp?

rp1-dev-mcp is a Model Context Protocol (MCP) server listed in the TrackMCP directory.

How do I install rp1-dev-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is rp1-dev-mcp open source?

Yes — it is hosted on GitHub at https://github.com/jl-codes/rp1-dev-mcp and has 2 stars.

Related MCP tools

servers

Model Context Protocol Servers

90,051 TypeScript

n8n-mcp

A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you

22,825 TypeScript

mcpmcp-servern8n+1

Figma-Context-MCP

MCP server to provide Figma layout information to AI coding agents like Cursor

15,766 TypeScript

aicursorfigma+2

butterbase

Open-source backend-as-a-service. Postgres, auth, storage, functions, AI gateway, MCP.

3,389 TypeScript

baasbackend-as-a-servicemcp+4

supermemory-mcp

Your memories are in ChatGPT... But nowhere else. Universal Memory MCP makes your memories available to every single LLM. No logins or paywall. One command to set it up.

1,714 TypeScript

cloudflaremcp