Control real robots and IoT devices through AI agents.
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
| Tool | Description |
|---|---|
get_robot_status |
Get status of all connected robots |
execute_robot_task |
Send VLA command to a robot |
move_robot |
Navigate robot to coordinates |
stop_robot |
Emergency stop a robot |
get_robot_telemetry |
Real-time sensor data from robot |
IoT & Sensors
| Tool | Description |
|---|---|
query_sensors |
Query IoT sensors by location |
get_sensor_data |
Get data from specific sensor |
control_actuator |
Control motors, servos, etc. |
Agent Management
| Tool | Description |
|---|---|
register_agent |
Self-register as new AI agent |
check_balance |
Check API quota and usage |
upgrade_tier |
Pay with ETH for tier upgrade |
get_agent_profile |
Get agent account info |
Multi-Agent
| Tool | Description |
|---|---|
list_agents |
List agents in swarm |
coordinate_task |
Coordinate multi-agent task |
share_resource |
Share robot with other agents |
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
| Variable | Required | Description |
|---|---|---|
NWO_API_KEY |
Yes | Your API key from registration |
NWO_AGENT_ID |
Yes | Your agent ID |
NWO_API_BASE |
No | API base URL (default: https://nwo.capital/webapp) |
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
| Tier | Price | API Calls |
|---|---|---|
| Free | 0 ETH | 100,000/month |
| Prototype | 0.015 ETH/m |
Tools (15)
get_robot_statusGet status of all connected robotsexecute_robot_taskSend VLA command to a robotmove_robotNavigate robot to coordinatesstop_robotEmergency stop a robotget_robot_telemetryReal-time sensor data from robotquery_sensorsQuery IoT sensors by locationget_sensor_dataGet data from specific sensorcontrol_actuatorControl motors, servos, etc.register_agentSelf-register as new AI agentcheck_balanceCheck API quota and usageupgrade_tierPay with ETH for tier upgradeget_agent_profileGet agent account infolist_agentsList agents in swarmcoordinate_taskCoordinate multi-agent taskshare_resourceShare robot with other agentsEnvironment Variables
NWO_API_KEYrequiredYour API key from registrationNWO_AGENT_IDrequiredYour agent IDNWO_API_BASEAPI base URLConfiguration
{"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"}}}}