git clone https://github.com/RedCiprianPater/mcp-server-robotics.git
cd mcp-server-robotics

npm install

cp .env.example .env
# Edit .env and add your NWO_API_KEY
nano .env

npm run build
npm start

# The server will start and display available tools
# You can now use any of the 77 tools through Claude

✅ nwo_initialize_slam              - Persistent robot mapping
✅ nwo_localize                     - Landmark-based localization
✅ nwo_create_rl_env                - Cloud RL training environments
✅ nwo_train_policy                 - Policy training (SB3)
✅ nwo_detect_objects_grounding     - Open-vocabulary detection

✅ nwo_query_thermal                - Heat detection
✅ nwo_query_mmwave                 - Millimeter-wave radar
✅ nwo_query_gas                    - Air quality sensors
✅ nwo_query_acoustic               - Sound localization
✅ nwo_query_magnetic               - Metal detection

✅ nwo_read_tactile                 - ORCA Hand 576 taxels
✅ nwo_identify_material            - Material recognition
✅ nwo_plan_motion                  - MoveIt2 motion planning
✅ nwo_execute_behavior_tree        - Hierarchical task execution

Inference & Models (6)              Robot Control (3)
Task Planning & Learning (4)        Agent Management (3)
Voice & Gesture (2)                 Simulation & Physics (3)
ROS2 & Hardware (3)                 MQTT & IoT (2)
Safety & Monitoring (3)             Embodiment & Calibration (3)
Autonomous Agents (4)               Dataset & Export (2)
Demo & Testing (2)

export NWO_API_KEY="sk_live_your_key_here"

# Standard API (full features)
NWO_API_BASE=https://nwo.capital/webapp/api-key.php

# Edge API (ultra-low latency, 200+ locations)
NWO_EDGE_API=https://nwo-robotics-api-edge.ciprianpater.workers.dev/api

# ROS2 Bridge (for physical robots)
NWO_ROS2_BRIDGE=https://nwo-ros2-bridge.onrender.com

# MQTT Broker (IoT sensors)
MQTT_BROKER=mqtt.nwo.capital
MQTT_PORT=8883

// Initialize SLAM mapping
const slam = await client.messages.create({
  tools: [{name: "nwo_initialize_slam", input: {
    agent_id: "robot_001",
    map_name: "warehouse",
    slam_type: "hybrid",
    loop_closure: true
  }}]
});

// Later: Localize in the map
const localize = await client.messages.create({
  tools: [{name: "nwo_localize", input: {
    agent_id: "robot_001",
    map_id: "map_123",
    image: "base64_encoded_image"
  }}]
});

// Detect objects with natural language
const detect = await client.messages.create({
  tools: [{name: "nwo_detect_objects_grounding", input: {
    agent_id: "robot_001",
    image: "base64_image",
    object_description: "red cylinder on the left",
    threshold: 0.85,
    return_mask: true
  }}]
});

// Execute action based on detection
const execute = await client.messages.create({
  tools: [{name: "nwo_inference", input: {
    instruction: "Pick up the detected object",
    images: ["base64_image"]
  }}]
});

// Break down high-level instruction
const plan = await client.messages.create({
  tools: [{name: "nwo_task_planner", input: {
    instruction: "Clean the warehouse floor",
    agent_id: "robot_001",
    context: {
      location: "warehouse",
      known_objects: ["shelves", "boxes"]
    }
  }}]
});

// Execute subtasks
for (let i = 1; i > .gitignore
echo ".env" >> .gitignore

# Use environment variables or .env (in .gitignore)

const balance = await client.messages.create({
  tools: [{name: "nwo_agent_check_balance", input: {
    agent_id: "agent_123"
  }}]
});

### Metrics

## 🎯 Next Steps

1. ✅ **Setup**: `npm install && npm run build`
2. ✅ **Configure**: Add `NWO_API_KEY` to `.env`
3. ✅ **Test**: `npm start` and verify tools load
4. ✅ **Integrate**: Use with Claude API or your framework
5. ✅ **Deploy**: Docker Compose or Kubernetes
6. ✅ **Monitor**: Check logs and usage metrics
7. ✅ **Scale**: Upgrade tier as needed

## 📞 Support

- **Issues**: https://github.com/RedCiprianPater/mcp-server-robotics/issues
- **Discussions**: https://github.com/RedCiprianPater/mcp-server-robotics/discussions
- **API Key Help**: https://nwo.capital/webapp/api-key.php
- **NWO Docs**: https://nwo.capital/nwo-robotics.html

## 📝 Version History

### v2.0.0 (Current - April 2026)
- ✅ 77 total tools implemented
- ✅ Priority 1: SLAM, RL, Grounding (5)
- ✅ Priority 2: Advanced Sensors (5)
- ✅ Priority 3: Advanced Features (4)
- ✅ Standard Operations (58)
- ✅ Complete TypeScript support
- ✅ Docker & Kubernetes ready
- ✅ Production-grade error handling
- ✅ Full test coverage

### v1.0.0 (Previous)
- Basic tool set (20 tools)
- Standard inference only
- Manual configuration

## 📄 License

MIT License - See LICENSE file for details

## 🙏 Acknowledgments

- **NWO Robotics** - API and infrastructure
- **Anthropic** - Claude and MCP protocol
- **Open Source Community** - Contributions and feedback

---

**Last Updated**: April 2026  
**Status**: ✅ Production Ready  
**Maintainer**: [@RedCiprianPater](https://github.com/RedCiprianPater)

### ⭐ If you find this useful, please star the repository!

---

## 🔗 Related Projects

- [NWO Robotics API](https://nwo.capital/)
- [Xiaomi Robotics 0](https://huggingface.co/XiaomiRobotics/Xiaomi-Robotics-0)
- [MCP Protocol](https://modelcontextprotocol.io/)
- [Anthropic Claude](https://www.anthropic.com/)