MCP Overview

Package: @robertoagent/mcp

What It Provides

@robertoagent/mcp exposes a stdio MCP server for agent clients. It includes health/version/capability discovery, user auth tools, agent lifecycle tools, runtime/channel agent operations, and billing/usage tools.

How To Run

Directly (package binary):

npx @robertoagent/mcp

Via CLI wrapper:

roberto mcp

Auth Behavior

MCP auth tools use the same device-flow endpoints as CLI and persist user auth state to a local file (default ~/.config/roberto/auth.json).

Current Tooling Scope

Implemented tools:

health
version
capabilities
auth_login_start
auth_login_poll
auth_status
auth_logout
auth_whoami
agents_list
agents_get
agents_create
agents_update
agents_delete
agents_provision
agents_start
agents_stop
agents_status
agents_clone
agents_runtime_update_status
agents_runtime_update_grant
agents_gateway_access
agents_connect_telegram
agents_whatsapp_qr
agents_whatsapp_wait
task_catalog
task_run
billing_status
billing_summary
billing_usage_summary
billing_checkout
billing_credits_checkout
billing_portal
billing_sync
billing_setup
billing_runtime_requests_list
billing_runtime_request_get
billing_runtime_request_approve
billing_runtime_request_deny
billing_runtime_spend_policy_get
billing_runtime_spend_policy_set
billing_runtime_spend_policy_revoke
runtime_delegations_list
runtime_delegation_create
runtime_delegation_revoke
runtime_auth_status
runtime_updates_manifest
runtime_updates_check
runtime_updates_apply
runtime_updates_report
runtime_agents_start
runtime_agents_stop
runtime_agents_status