# Well

Well connects your AI coder to a structured database of companies, contacts, and invoices. Query records by field, create new profiles, and export data for reports through a single API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 4088 installs
- Author: well
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/well/app
- Updated: 2026-01-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/well

## What it does

Well exposes four tools for managing business data. `well_get_schema` lists all available fields across data roots: invoices, companies, people, documents, and connectors. `well_query_records` fetches records filtered by the fields you specify—pull all invoices for a company, find contacts by domain, or retrieve specific documents. `well_create_company` adds a new company (name required; domain, tax ID, and description are optional). `well_create_person` registers a contact with first name, last name, email, and job title.

Always call `well_get_schema` first to discover what fields exist in each root. This prevents query errors and lets you select only the columns you need. The server runs at `https://app--well.run.tools`.

## Requirements
- Remote server: `https://app--well.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http app https://app--well.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add well --url https://app--well.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "well": {
            "url": "https://app--well.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "well": {
            "type": "http",
            "url": "https://app--well.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http well https://app--well.run.tools
```

## When to use it
- pull all invoices for a company in one request
- find contacts across the database by email or domain
- register a new company with tax ID and business details
- add a contact and link it to an existing company
- build a report or dashboard from Well records

## Example prompts
- Show me all invoices from the last quarter with amounts and dates
- Find all contacts in the example.com domain
- Create a new company named Acme Inc with tax ID 123456789

## Similar
- [architecture-well-architected-commerce](https://affpapa.org/en/nevibecode/skills/architecture-well-architected-commerce.md) — skill · 1300 installs
- [delete-no-email-contacts](https://affpapa.org/en/nevibecode/skills/delete-no-email-contacts.md) — skill · ★ 81 repo stars
- [lexware](https://affpapa.org/en/nevibecode/mcp/lexware.md) — MCP server · ★ 9 repo stars
- [FlexPrice](https://affpapa.org/en/nevibecode/mcp/flexprice.md) — MCP server
- [sms-alert](https://affpapa.org/en/nevibecode/skills/sms-alert.md) — skill · 185 installs
- [DirectIQ](https://affpapa.org/en/nevibecode/mcp/directiq.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
