Skip to main content
Glama
openbot-mcp

openbot-mcp

Official
by openbotai

openbot-mcp

openbot-mcp is the Model Context Protocol server for OpenBot.ai. It lets AI agents such as Claude Code, Cursor and Claude Desktop use OpenBot tools for physical AI data work.

Status: skeleton. PyPI has only the pre-release 0.1.0.dev0, published to reserve the name; pip install openbot-mcp does not select it. Only the server_status tool exists. Data audit, training readiness, Catalog and judgment tools are being designed.

Run from source

pip install -e ".[dev]"
OPENBOT_MCP_ROOTS=/path/to/data openbot-mcp

Claude Code:

claude mcp add openbot -e OPENBOT_MCP_ROOTS=/path/to/data -- openbot-mcp

Other MCP clients use the same command in their MCP configuration file:

{
  "mcpServers": {
    "openbot": {
      "command": "openbot-mcp",
      "env": { "OPENBOT_MCP_ROOTS": "/path/to/data" }
    }
  }
}

Related MCP server: MCP Workspace Server

Configuration

Variable

Required

Description

OPENBOT_MCP_ROOTS

Yes, for local tools

Directories the server may read, separated by the OS path separator. Paths outside them, including symlinks that point outside, are rejected.

OPENBOT_MCP_OUTPUT_DIR

No

Where artifacts are written. Default ./openbot-output.

OPENBOT_BASE_URL

No

OpenBot API base URL. Default https://api.openbot.ai/v1.

OPENBOT_MCP_REDACT_PATHS

No

Default true: replace file paths with episode-relative ids in evidence sent to paid APIs.

OPENBOT_MCP_PAID_TOOLS

No

Default false: paid tools stay hidden until they are available.

Data boundary

Local tools only read the directories in OPENBOT_MCP_ROOTS and only write to the output directory. The server never modifies source data, never runs shell commands and collects no telemetry.

Development

pip install -e ".[dev]"
python scripts/check_version.py
pytest -v
ruff check src tests scripts
mypy src
python -m build

VERSION is the package version source of truth. To release, update VERSION and CHANGELOG.md, verify locally, then publish a GitHub Release whose tag is v<version>. The release workflow tests every supported Python, builds the distributions and publishes to PyPI through a trusted publisher.

Package boundaries

  • openbot-mcp: MCP server for AI agents.

  • openbot-data: local robot/ego data processing library.

  • openbot-sdk: OpenBot platform API client.

License

MIT

Available Tools

1 tool
server_statusA
Read-only

Report the OpenBot MCP server version and which local directories it may read.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only a single tool exists, so there is no possibility of confusion between tools. The tool's purpose is clear and distinct.

    Naming Consistency5/5

    With only one tool, naming is trivially consistent. The name follows a clean noun_noun pattern with no conflicting conventions.

    Tool Count1/5

    A single trivial status tool is far too few for an MCP server that presumably should provide meaningful bot-related functionality. This is an extreme mismatch.

    Completeness1/5

    The server only exposes a status/version endpoint and does not provide any actual operations, data access, or workflow coverage. The surface is severely incomplete for any plausible domain.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables AI tools to perform server operations such as log inspection, system monitoring, code management, Nginx and certificate management, with support for local and remote SSH modes and built-in security controls.
      23
      60 npm
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Turns web-based AI chat clients into secure operators of a local machine by exposing a governed, OAuth-gated set of 38 tools for file read/write/edit, whitelisted shell commands, search, Git, SQLite, browser automation, DevTools, background tasks, localhost/LAN fetching, clipboard, notifications, ports, Postman, and AIObox windows. Access is confined to user-approved folders with a strict command whitelist, rate limits, and a security log.
      -
    • A
      license
      A
      quality
      D
      maintenance
      This server enables AI agents to execute terminal commands, manage running processes, and interact with the host's filesystem and system configuration. It supports complex operations such as code execution, file searching, and surgical data editing.
      21
      721,771 npm
      MIT