MCP Server

Connect your AI coding tools directly to Hyperscape documentation using the Model Context Protocol (MCP). This allows Claude, Cursor, VS Code, and other AI tools to search our documentation in real-time while generating responses.

MCP is an open protocol that creates standardized connections between AI applications and external services. When connected, your AI tool can proactively search Hyperscape documentation during response generation.

Hyperscape MCP Server URL

https://hyperscape-ai.mintlify.app/mcp

Benefits

Real-Time Documentation

AI tools search our docs during response generation, not just when asked

Accurate Answers

Get precise Hyperscape-specific guidance instead of generic responses

Always Up-to-Date

Documentation updates are immediately available to your AI tools

Contextual Search

AI determines relevance and searches automatically based on your questions

Connect Your AI Tool

Select your AI tool below for setup instructions:

Cursor
Claude Code
VS Code
Claude Web/Desktop

Step 1: Open MCP Settings

Press Ctrl + Shift + P (Windows/Linux) or Cmd + Shift + P (macOS) to open the command palette
Search for “Open MCP settings”
Select Add custom MCP to open the mcp.json file

Step 2: Add Configuration

Add the following to your mcp.json:

{
  "mcpServers": {
    "Hyperscape": {
      "url": "https://hyperscape-ai.mintlify.app/mcp"
    }
  }
}

Step 3: Test the Connection

In Cursor’s chat, ask:

“What tools do you have available?”

Cursor should show Hyperscape as an available MCP tool.

Step 4: Start Using It

Ask Cursor questions about Hyperscape development:

“How do I set up the Hyperscape development environment?”
“What are the combat constants in Hyperscape?”
“How does the ECS system work in Hyperscape?”

See the Cursor MCP documentation for more details.

Step 1: Add the MCP Server

Run the following command in your terminal:

claude mcp add --transport http Hyperscape https://hyperscape-ai.mintlify.app/mcp

Step 2: Verify the Connection

Check that the server was added:

claude mcp list

You should see Hyperscape in the list of connected MCP servers.

Step 3: Start Using It

Claude Code will now automatically search Hyperscape documentation when relevant to your questions. Try asking:

“How do I set up the Hyperscape development environment?”
“What are the combat constants in Hyperscape?”
“How does the ECS system work in Hyperscape?”

See the Claude Code MCP documentation for more details.

Step 1: Create MCP Configuration File

Create a .vscode/mcp.json file in your project root:

{
  "servers": {
    "Hyperscape": {
      "type": "http",
      "url": "https://hyperscape-ai.mintlify.app/mcp"
    }
  }
}

Step 2: Reload VS Code

Reload your VS Code window to apply the MCP configuration (Ctrl + Shift + P → “Reload Window”).

Step 3: Test the Connection

Use the VS Code Copilot chat to ask questions about Hyperscape:

“How do I set up the Hyperscape development environment?”
“What are the combat constants in Hyperscape?”
“How does the ECS system work in Hyperscape?”

See the VS Code MCP documentation for more details.

Step 1: Navigate to Connectors

Open Claude in your browser or desktop app
Go to Settings → Connectors

Step 2: Add Custom Connector

Select Add custom connector
Enter the following details:
- Name: Hyperscape
- URL: https://hyperscape-ai.mintlify.app/mcp
Click Add

Step 3: Use in Conversations

When chatting with Claude, click the attachments button (plus icon)
Select Hyperscape from the list
Ask questions about Hyperscape development:

“How do I set up the Hyperscape development environment?”
“What are the combat constants in Hyperscape?”
“How does the ECS system work in Hyperscape?”

See the Claude MCP documentation for more details.

How It Works

When an AI tool has the Hyperscape MCP server connected:

Contextual Detection: The AI determines when Hyperscape documentation is relevant to your question
Automatic Search: The AI searches our documentation during response generation
Real-Time Integration: Search results are incorporated into the AI’s response
No Manual Prompting: You don’t need to explicitly ask the AI to search the docs

Example Queries

Once connected, try asking your AI tool:

Development Setup

“How do I install Hyperscape locally?”
“What are the prerequisites for running the dev server?”
“How do I run the game with AI agents?”

Architecture Questions

“Explain the Entity Component System in Hyperscape”
“How does the combat system calculate damage?”
“What is the tick duration in Hyperscape?”

AI Agent Development

“What actions are available for ElizaOS agents?”
“How do I create a new AI agent action?”
“What providers give context to AI agents?”

Game Systems

“How does the banking system work?”
“What are the mob AI states?”
“How are ground items handled?”

Troubleshooting

Cursor
Claude Code
VS Code
Claude Web/Desktop

MCP server not appearing?

Press Ctrl + Shift + P and search “Open MCP settings”
Verify your mcp.json has valid JSON syntax (no trailing commas)
Restart Cursor after saving the configuration

Not getting Hyperscape-specific answers?

Mention “Hyperscape” explicitly in your question
Check that the MCP server shows as connected in Cursor’s tools

Server not added?

Ensure you have the latest Claude Code installed
Run claude mcp list to verify the server was added
Try removing and re-adding: claude mcp remove Hyperscape then add again

Connection issues?

Check your internet connection
Verify the URL is exactly https://hyperscape-ai.mintlify.app/mcp

Configuration not recognized?

Ensure the file is at .vscode/mcp.json (not just mcp.json)
Reload VS Code window after creating the file
Check for JSON syntax errors

Copilot not using the MCP?

Make sure you have GitHub Copilot extension installed
Verify MCP support is enabled in your VS Code version

Get Started

Guides

Core Concepts

MCP Server

MCP Server

Hyperscape MCP Server URL

Benefits

Real-Time Documentation

Accurate Answers

Always Up-to-Date

Contextual Search

Connect Your AI Tool

Step 1: Open MCP Settings

Step 2: Add Configuration

Step 3: Test the Connection

Step 4: Start Using It

Step 1: Add the MCP Server

Step 2: Verify the Connection

Step 3: Start Using It

Step 1: Create MCP Configuration File

Step 2: Reload VS Code

Step 3: Test the Connection

Step 1: Navigate to Connectors

Step 2: Add Custom Connector

Step 3: Use in Conversations

How It Works

Example Queries

Troubleshooting

​MCP Server

​Hyperscape MCP Server URL

​Benefits

Real-Time Documentation

Accurate Answers

Always Up-to-Date

Contextual Search

​Connect Your AI Tool

​Step 1: Open MCP Settings

​Step 2: Add Configuration

​Step 3: Test the Connection

​Step 4: Start Using It

​Step 1: Add the MCP Server

​Step 2: Verify the Connection

​Step 3: Start Using It

​Step 1: Create MCP Configuration File

​Step 2: Reload VS Code

​Step 3: Test the Connection

​Step 1: Navigate to Connectors

​Step 2: Add Custom Connector

​Step 3: Use in Conversations

​How It Works

​Example Queries

​Troubleshooting

​Related Resources

MCP Server

Hyperscape MCP Server URL

Benefits

Connect Your AI Tool

Step 1: Open MCP Settings

Step 2: Add Configuration

Step 3: Test the Connection

Step 4: Start Using It

Step 1: Add the MCP Server

Step 2: Verify the Connection

Step 3: Start Using It

Step 1: Create MCP Configuration File

Step 2: Reload VS Code

Step 3: Test the Connection

Step 1: Navigate to Connectors

Step 2: Add Custom Connector

Step 3: Use in Conversations

How It Works

Example Queries

Troubleshooting

Related Resources