MCP

localcode is an MCP client. The servers you add give the agent access to their tools alongside the built-in tools.

Add a server

Declare servers under the mcp key of localcode.json in the project root. A local server is a command to run; a remote server is a URL:

Project configuration is ignored until you launch with localcode --trust-project. Review local server commands and plugin code before enabling it. For servers you want available in every project, use your user-global ~/.config/localcode-agent/localcode.json instead.

{
  "$schema": "https://localcode.dev/schema/config.json",
  "mcp": {
    "filesystem": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Add "enabled": false to a server to keep it configured but off. Local servers can take an "environment" object for variables the command needs. The file follows the opencode config schema; see Configuration.

From the interface

/mcps lists the configured servers and toggles each one on or off for the session. The tools of every enabled server appear to the model next to the built-in tools.

MCP tools run without a permission prompt when the model calls them. A remote server is a network path; see Network Boundary.