Skip to content

Model Context Protocol

Connect any external tool to Lurus Code via the Model Context Protocol (MCP). Database access, file systems, GitHub, web search and more — all from the terminal.

🔧

Dynamic Tool Registry

Tools register at runtime, new capabilities without restarting the session.

⚙️

Server Management

`lurus mcp add/remove`, add, update, or remove MCP servers cleanly.

📄

Config (.lurus/mcp.json)

Project-scoped MCP settings you can version and share with the team.

🔗

IDE Bridge (VS Code/MCP)

The IDE as an MCP endpoint, context and actions stay in sync with the agent.

🔌

Tool Adapter

A unified surface for heterogeneous tools and APIs behind MCP.

📦

Resource Access

Use MCP resources, files, metadata, and more as structured context.

What is MCP?

Model Context Protocol (MCP) is an open standard by Anthropic for connecting AI models to external tools and data sources. An MCP server exposes a set of tools via JSON-RPC over stdio — the AI discovers and calls them dynamically during the session.

  • Open standard — any language, any runtime
  • Tools discovered automatically at session start
  • Stateless JSON-RPC calls over stdio
  • Versioned and shareable via .lurus/settings.json

MCP Architecture

Lurus Code Agent
↕ JSON-RPC over stdio
Filesystem
GitHub
Database

Adding MCP Servers

Add any MCP server with lurus mcp add. Servers start automatically at session init and their tools appear in /mcp.

Filesystem access

lurus mcp add filesystem \
  --command npx \
  --args @modelcontextprotocol/server-filesystem /

GitHub integration

lurus mcp add github \
  --command npx \
  --args @modelcontextprotocol/server-github \
  --env GITHUB_TOKEN=ghp_xxx

Popular MCP Servers

Filesystem

Full read/write access to local files and directories

@modelcontextprotocol/server-filesystem

GitHub

Repository management, PRs, issues, and code search

@modelcontextprotocol/server-github

PostgreSQL

Run SQL queries and explore database schemas

@modelcontextprotocol/server-postgres

Brave Search

Privacy-friendly web search (no tracking, GDPR-compliant)

@modelcontextprotocol/server-brave-search
⚠️

Trust Model

By default, MCP tool calls require confirmation like any other tool. Use --trust for servers you own (e.g. your own database server). Never trust third-party servers automatically.

Related

Custom Agents

Build custom AI agents with YAML

Skills

Reusable prompt templates

📝 What Is an AI Coding Agent?

Everything about autonomous AI coding agents

Ready to code smarter?

Join the waitlist and connect external tools to Lurus Code via MCP.

Get started