Skip to main content

Claude Code Setup

Connect noBGP to Claude Code, Anthropic's CLI tool for agentic coding.

Installation​

Add the noBGP MCP server to your Claude Code configuration. In your project's .mcp.json or global settings, add:

{
  "mcpServers": {
    "nobgp": {
      "type": "http",
      "url": "https://mcp.nobgp.com/mcp"
    }
  }
}

Authentication​

After adding the MCP server, authenticate with noBGP by running /mcp in Claude Code, selecting the nobgp server, and completing the OAuth flow in your browser.

Running Claude Code on a noBGP node?

If the machine is itself a registered node, an Owner or Admin can grant it a role and nobgp mcp install registers that node's local MCP server instead — no OAuth, and it keeps working while the router is unreachable. See Local MCP Server.

Both want the name nobgp. From agent 0.4.126 nobgp mcp install refuses to replace a nobgp entry in your user configuration (~/.claude.json) that is not a local node's. It does not read a project .mcp.json, and a nobgp entry there takes precedence in that project, so the local server is not used. To keep both, rename the entry above to nobgp-public.

Available Tools​

Once connected, Claude Code can use these noBGP tools:

Networks

  • node_list - List your nodes, with their state and services
  • network_list - List your networks
  • network_create / network_delete - Manage networks

Organizations

  • org_create - Create a new organization

Nodes

  • provision_node - Provision a new cloud node
  • task_stop - Stop a provisioned machine and keep its node
  • deprovision_node - Stop and remove a provisioned node
  • task_deadline_set - Give a running machine more time, or less
  • register_node - Generate registration code for self-hosted nodes
  • command - Run commands and interactive shells on remote nodes

Services

  • service_publish - Expose a port or command via public URL
  • service_update / service_delete - Manage published services
  • service_share - Manage authorized email lists for services

Filesystem

  • file - Unified read/write/edit/list/stat/delete/mkdir super-tool
  • fs_read / fs_write - Stream files between client and agent (binary-safe, checksummed, resumable)
  • fs_edit - Atomic diff-style edits (sends ~200 bytes instead of rewriting the whole file)
  • fs_list / fs_stat / fs_delete / fs_mkdir - Directory and metadata ops

Network Diagnostics

  • net_peers - Agent's peer directory
  • net_interfaces - Host network interfaces
  • net_metrics - Agent Go runtime metrics (uptime, goroutines, heap, GC), plus a host block for the machine
  • net_routes - Kernel routing table (Linux)
  • net_dns - Resolver configuration (Unix)
  • node_logs - The node's own agent log, by whatever mechanism that node has

Node Labels, Grants and Settings

  • node_label / node_grant / node_revoke
  • node_config_get / node_config_set - Read and change a node's own agent settings, over its control channel — so they still answer on a node whose sessions are all dead

Event Bus

  • fs_subscribe / command_subscribe / presence_subscribe / fs_grep_subscribe / event_tail / event_unsubscribe / event_publish / event_subscriptions

Account

  • whoami - Show authenticated user info

Feedback

  • feedback_submit - Tell us where this tool surface fought you

For parameters and semantics see the full MCP Reference.

Example Usage​

Ask Claude Code to manage your infrastructure:

Show me my noBGP networks and nodes
Provision a new node called "dev-server"
Run "df -h" on my raspberry pi node
Publish port 8080 on my-node as a public web service

More Information​