NWO Robotics MCP Server

A Model Context Protocol (MCP) server for the NWO Robotics API. Enables AI agents (Claude, Cursor, etc.) to discover and control real robots through a standardized tool interface.

What is MCP?

The Model Context Protocol (MCP) is an open standard by Anthropic that allows AI assistants to discover and use tools dynamically. This server exposes NWO Robotics capabilities as MCP tools that any MCP-compatible agent can use.

Features

• 🤖 Robot Control - Send VLA (Vision-Language-Action) commands to robots
• 📡 IoT Monitoring - Query sensors and control actuators
• 🔑 Self-Registration - Agents can register and get API keys
• 💎 Autonomous Payment - Pay with ETH for tier upgrades
• 👥 Multi-Agent Support - Join coordinated agent swarms
• 📊 Real-time Telemetry - Monitor robot status and sensor data

Installation

Option 1: NPM (Recommended)

npm install -g @nwo-capital/mcp-server-robotics

Option 2: Docker

docker pull nwocapital/mcp-server-robotics

Option 3: Direct from GitHub

npx -y @nwo-capital/mcp-server-robotics

Configuration

Step 1: Get API Credentials

Register as an AI agent at https://nwo.capital/webapp/agent.md or use the self-registration tool.

Step 2: Configure MCP Client

Add to your Claude Desktop, Cursor, or other MCP client:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "nwo-robotics": {
      "command": "npx",
      "args": ["-y", "@nwo-capital/mcp-server-robotics"],
      "env": {
        "NWO_API_KEY": "your_api_key_here",
        "NWO_AGENT_ID": "your_agent_id_here"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "nwo-robotics": {
      "command": "npx",
      "args": ["-y", "@nwo-capital/mcp-server-robotics"],
      "env": {
        "NWO_API_KEY": "your_api_key_here",
        "NWO_AGENT_ID": "your_agent_id_here"
      }
    }
  }
}

Docker:

{
  "mcpServers": {
    "nwo-robotics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "NWO_API_KEY",
        "-e", "NWO_AGENT_ID",
        "nwocapital/mcp-server-robotics"
      ],
      "env": {
        "NWO_API_KEY": "your_api_key_here",
        "NWO_AGENT_ID": "your_agent_id_here"
      }
    }
  }
}

Available Tools

Robot Control

IoT & Sensors

Agent Management

Multi-Agent

Usage Examples

Example 1: Control a Robot

User: "Move robot_001 to the loading dock"

Claude uses: execute_robot_task
{
  "robot_id": "robot_001",
  "instruction": "Move to loading dock",
  "coordinates": {"x": 50, "y": 100}
}

Example 2: Query Sensors

User: "What's the temperature in warehouse 3?"

Claude uses: query_sensors
{
  "location": "warehouse_3",
  "sensor_type": "temperature"
}

Example 3: Check API Usage

User: "How many API calls do I have left?"

Claude uses: check_balance
{} → Returns quota remaining

Environment Variables

Self-Registration

Don't have API credentials? The server includes a tool to self-register:

User: "Register me as a new agent with wallet 0x123..."

Claude uses: register_agent
{
  "wallet_address": "0x123...",
  "agent_name": "MyAgent",
  "capabilities": ["vision", "navigation"]
}

API Pricing

Links

• Homepage: https://nworobotics.cloud
• Documentation: https://nwo.capital/webapp/agent.md
• API Dashboard: https://nwo.capital/webapp/api-key.php
• MCP Directory: https://mcp.so
• GitHub: https://github.com/nwocapital/mcp-server-robotics

Support

• Email: ciprian.pater@publicae.org
• Discord: NWO Robotics Community

License

MIT-0 - No Attribution Required

Contributing

Contributions welcome! See CONTRIBUTING.md