# Connect your AI agent to Lidia Labs

Give Claude Code, Cursor, Codex, Antigravity and friends the power to manage your
Lidia Labs business — contacts, calendar, WhatsApp inbox, the Lidia AI agent and
more — in plain language.

Two steps: **(1) connect the MCP** and **(2) drop in the agent guide** so the
assistant knows how to use it well.

- MCP endpoint: `https://lidialabs.com/api/mcp`
- REST base URL: `https://lidialabs.com/api/v1`
- Agent guide: `https://lidialabs.com/mcp/lidia-labs.md`
- Get an API key: lidialabs.com → Configuración → Conexiones → **Crear API key**
  (choose granular read/write permissions per resource). Replace `YOUR_API_KEY`
  below with it.

---

## 1. Connect the MCP

### Claude Code

```bash
claude mcp add --transport http lidia https://lidialabs.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

### Cursor — `.cursor/mcp.json`

```json
{ "mcpServers": { "lidia": {
  "url": "https://lidialabs.com/api/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
} } }
```

### Windsurf — `~/.codeium/windsurf/mcp_config.json`

```json
{ "mcpServers": { "lidia": {
  "serverUrl": "https://lidialabs.com/api/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
} } }
```

### Antigravity — Manage MCP Servers → `mcp_config.json`

```json
{ "mcpServers": { "lidia": {
  "serverUrl": "https://lidialabs.com/api/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
} } }
```

### GitHub Copilot (VS Code) — `.vscode/mcp.json`

```json
{ "servers": { "lidia": {
  "type": "http",
  "url": "https://lidialabs.com/api/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
} } }
```

### Kiro — `.kiro/settings/mcp.json`

```json
{ "mcpServers": { "lidia": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://lidialabs.com/api/mcp",
           "--header", "Authorization: Bearer YOUR_API_KEY"]
} } }
```

### Codex

```bash
codex mcp add lidia -- npx -y mcp-remote https://lidialabs.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

### Qoder — MCP settings

```json
{ "mcpServers": { "lidia": {
  "url": "https://lidialabs.com/api/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
} } }
```

Restart the client and ask the agent to call `get_business_info` — it should
answer with your business name. The server also ships **prompts** (quick
recipes: daily briefing, book appointment, triage inbox, capture lead, set up
Lidia) that compatible clients surface as commands.

---

## 2. Give the agent the guide

The MCP already sends a rich `instructions` block on connect, so most agents
"just know" how to use it. To make them even better, add the guide:

### Claude Code (skill) — recommended

Install the skill so Claude Code loads it automatically when relevant:

```bash
curl -fsSL https://lidialabs.com/mcp/claude-code/SKILL.md \
  --create-dirs -o ~/.claude/skills/lidia-labs/SKILL.md
```

(Use `.claude/skills/lidia-labs/SKILL.md` inside a project to scope it there.)

### Codex / Antigravity / generic — `AGENTS.md`

Append the contents of `https://lidialabs.com/mcp/AGENTS.md` to your project's
`AGENTS.md`:

```bash
curl -fsSL https://lidialabs.com/mcp/AGENTS.md >> AGENTS.md
```

### Cursor — project rule

Save the guide as a rule so Cursor always has it:

```bash
curl -fsSL https://lidialabs.com/mcp/lidia-labs.md \
  --create-dirs -o .cursor/rules/lidia-labs.md
```

### Windsurf — `.windsurfrules`

```bash
curl -fsSL https://lidialabs.com/mcp/lidia-labs.md >> .windsurfrules
```

### GitHub Copilot — `.github/copilot-instructions.md`

```bash
curl -fsSL https://lidialabs.com/mcp/lidia-labs.md \
  --create-dirs -o .github/copilot-instructions.md
```

### Kiro — steering doc

```bash
curl -fsSL https://lidialabs.com/mcp/lidia-labs.md \
  --create-dirs -o .kiro/steering/lidia-labs.md
```

### Qoder / others

Add `https://lidialabs.com/mcp/lidia-labs.md` as a rules/context document, or
just paste it into your agent's custom instructions.

---

## What the agent can now do

Everything scoped to what your key allows: read/write contacts, manage the
calendar, take notes, read and reply in the WhatsApp inbox, edit Lidia's system
prompt and image catalog, manage members and organization settings, and even
create or revoke API keys. Try:

> "Give me a briefing of my day."
> "Reply on WhatsApp to Laura that Thursday at 5 works, then close the chat."
> "Update Lidia's system prompt to mention this week's 2-for-1."

Full reference for agents: **https://lidialabs.com/mcp/lidia-labs.md**