>_lisa docs

MCP Server

Connect Lisa to AI coding agents via the Model Context Protocol.

Lisa provides an MCP (Model Context Protocol) server that allows AI coding agents like Claude Code, Cursor, and Windsurf to create and manage issues directly.

What is MCP?

The Model Context Protocol is an open standard for connecting AI tools to external data sources and services. Lisa's MCP server exposes issue management, project planning, and artifact creation as tools that AI agents can invoke.

Setup

Claude Code

Add to your .claude/mcp.json:

{
  "mcpServers": {
    "lisa": {
      "command": "node",
      "args": ["path/to/lisa/mcp-server.ts"],
      "env": {
        "LISA_API_URL": "https://your-lisa-url",
        "LISA_API_KEY": "your-api-key",
        "LISA_ORG": "your-org-slug"
      }
    }
  }
}

Cursor / Windsurf

Configure the MCP server in your IDE's settings with the same connection details.

Available tools

The MCP server exposes Lisa's full tool set:

ToolDescription
issue-createCreate a new issue
issue-listList and filter issues
issue-updateUpdate issue fields
project-listList projects
milestone-listList milestones
artifact-createCreate PRDs, specs, and documents
discoveryStart a guided planning session

Usage

Once connected, your AI coding agent can:

  • "Create an issue for the bug I just found in auth.ts"
  • "List all high priority issues in the payments project"
  • "Update ISS-45 to in_progress — I'm starting work on it"

The AI agent uses Lisa's tools naturally as part of its workflow, keeping your product intelligence in sync with code changes.