Extended Reality of MCP

Define MCP tools once,deploy everywhere

xrMCP is a JSON manifest format and runtime protocol that lets you describe any API as a real, named MCP tool. Instead of shipping a server, you share a .xrmcp.json file.

Browse RegistryView on GitHub
$
get_blog_post.xrmcp.json
{
  "tool": {
    "schemaVersion": "xrmcp.v0.1.0",
    "name": "get_blog_post",
    "description": "Fetch a blog post by its ID.",
    "inputSchema": {...},
    "executions": [{
      "type": "api",
      "request": {
        "method": "GET",
        "url": "https://api.example.com/posts/{{input.postId}}"
      }
    }]
  }
}

Why xrMCP?

Today, sharing an MCP integration means sharing an entire server — not just a tool. People who want to share integrations need to build, host, maintain, and distribute MCP servers. xrMCP changes that with a portable manifest format that turns integrations into installable tools. Developers can share tools directly with the community, and anyone can install them instantly from an xrMCP-compatible runtime — no deployment, no infrastructure, no technical expertise required.

Getting Started

Three steps to install MCP tools with xrMCP and make them available to any AI.

01

Start a Runtime

Install the CLI and start the xrMCP runtime server. Choose between stdio or HTTP transport.

terminal
# Install via Homebrew
brew tap xrmcp/homebrew-tap
brew install xrmcp

# Start the runtime server
xrmcp server start -t http -p 8000
02

Install a Tool

Install tools from local manifests or directly from the public registry by name.

terminal
# Install from the registry
xrmcp tool install jira/get_jira_ticket

# Or install a local manifest
xrmcp tool install ./my-tool.xrmcp.json

# Search for tools
xrmcp tool search github
03

AI Uses Your Tool

The runtime exposes the tool as a proper MCP tool. Any MCP-compatible AI can now use it with the right name, schema, and behaviour.

terminal
# List installed tools
xrmcp tool ls

# The tool is now available to any MCP client
# Connect your AI agent to the runtime
# and it will discover the tool automatically

The xrMCP Ecosystem

Everything you need to install and share AI tools. xrMCP is fully open source and available on GitHub. Spec v0.1.0 is in active development — join the community, contribute, and help shape the future of portable MCP tools.

Ready to use MCP Tools without coding a server?

Start by browsing the registry or install the CLI. Describe your tool once in JSON, install it anywhere.

Explore RegistryCLI Documentation

Install via Homebrew

Also available via Scoop, Debian packages, or install script