Skip to main content
Glama
lovieco

Lovie Company Formation MCP

Official
by lovieco

lovie — Company Formation MCP Server

The Company Formation MCP for AI coding tools. Form companies, manage bank accounts, cards, invoices, and more — directly from your terminal.

Quick Start

npm install -g lovie

1. Log in

lovie login

This opens your browser to authenticate with your Lovie account.

2. Add to your AI tool

Claude Code

To add Lovie globally (available in all projects):

claude mcp add --scope user lovie npx lovie

To add Lovie to the current project only:

claude mcp add lovie npx lovie

Cursor — add to .cursor/mcp.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Windsurf — add to mcp_config.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Claude Desktop — add to claude_desktop_config.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

VS Code / GitHub Copilot — add to .vscode/mcp.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Replit — add to .replit or use the MCP panel in Replit Agent

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Lovable — in the MCP integration settings, add:

  • Name: lovie

  • Command: npx

  • Arguments: -y lovie

Manus — in the MCP tool configuration, add:

  • Name: lovie

  • Command: npx

  • Arguments: -y lovie

OpenAI (ChatGPT / Codex) — if MCP is supported, use the same stdio config:

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Any MCP-compatible platform — Lovie works with any tool that supports the MCP stdio protocol. Use npx -y lovie as the command, or lovie if installed globally.

That's it. Your AI tool now has access to 79 Lovie business tools.

Related MCP server: companylens-mcp

What You Can Do

Category

Tools

Company Formation

Start formation, set state, choose entity type, check name availability, add shareholders, generate certificate, pay filing fee

Bank Accounts

Create checking/savings/wallet, get balances, freeze/unfreeze, close accounts

Cards

Issue virtual/physical cards, set spending limits, freeze/unfreeze, cancel

Payments

Transfer between accounts, deposit funds, withdraw from wallet

Invoicing

Create/send/duplicate invoices, mark as paid, generate PDFs

Clients

Create and manage client records for invoicing

Transactions

List and filter transactions with AI-powered categorization

Linked Accounts

Connect external bank accounts via Plaid, sync transactions

User Profile

View/update profile, manage sessions, activity history

Commands

lovie              # Show setup instructions
lovie login        # Authenticate with Lovie
lovie logout       # Clear stored credentials
lovie status       # Check authentication status
lovie help         # Show help

How It Works

This package is a lightweight stdio-to-HTTP proxy. It connects your local AI tool to the Lovie MCP server:

AI Tool (Claude, Cursor, etc.)  ←— stdio —→  lovie (this package)  ←— HTTPS —→  Lovie MCP Server
  • On startup, discovers all available tools from the remote server

  • Forwards tool calls over HTTPS and returns results via stdio

  • Handles OAuth authentication, session management, and automatic token refresh

  • All business logic runs on the Lovie server — this package is just the bridge

Environment Variables

Variable

Description

LOVIE_MCP_URL

Custom MCP server URL (default: https://mcp.lovie.co/mcp/mcp)

LOVIE_API_KEY

Bearer token — overrides stored OAuth token

DEBUG

Enable verbose logging to stderr

Requirements

License

MIT

Available Tools

1 tool
lovie_auth_requiredAInspect

The user is not authenticated with Lovie. Tell them to run npx lovie login in their terminal to authenticate, then restart the MCP connection. All Lovie tools (company formation, banking, cards, invoices) will become available after login.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It clearly describes the tool's informational behavior and the required user action. It does not disclose any side effects, but for a simple notification tool, this is sufficient. No contradiction.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise—two sentences—and front-loaded with the key message. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters, no output schema, and a simple informational purpose, the description is complete. It tells the user exactly what to do and what to expect.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, and schema coverage is 100%. Per guidelines, baseline is 4. The description does not add parameter info, but none is needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the tool's purpose: to indicate that the user is not authenticated and to provide a specific command to authenticate. It specifies the action and outcome.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly tells when to use the tool (when user is not authenticated) and what the user should do (run `npx lovie login`). It also explains the result: all Lovie tools become available after login. No sibling tools exist, so differentiation is not needed.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.9
    • First observedlovie_auth_required

TDQS

A3.7/5.0

Scored across 1 tool

Disambiguation2/5

While there is only one tool, its purpose (requiring authentication) is fundamentally different from the server's claimed domain (company formation). This creates confusion about what the server actually does.

Naming Consistency2/5

The tool name 'lovie_auth_required' does not follow a verb_noun pattern and is more descriptive of a state than an action. With only one tool, no consistent naming pattern is established.

Tool Count1/5

A single tool claiming to be for company formation is far too few. The tool merely acts as an authentication gate, not a functional capability.

Completeness1/5

The tool surface is severely incomplete for company formation. No tools for company creation, banking, invoicing, etc. are actually provided despite the server name.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    CompanyLens MCP gives your AI assistant access to real corporate data from official government sources. No web scraping, no hallucinations — verified data from SEC EDGAR, UK Companies House, OpenSanctions, and USAspending.gov.
    5
    201 npm
    4
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    MCP server exposing the full UK Companies House Public Data API, enabling natural language queries for company profiles, search, officers, filing history, charges, insolvency, and persons with significant control, as well as downloading and reading PDF documents.
    -