@sedes/mcp-server

MCP server for LLC formation through Sedes -- the AI-native business formation and registered agent platform. Form an LLC in any US state with transparent pricing, no hidden fees, and full AI assistant support.

What is this?

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude, ChatGPT, and Gemini call external tools. This server gives any MCP-compatible AI the ability to:

• Check if a business name is available in any US state
• Recommend the best state for your LLC based on your needs
• Get transparent, line-item pricing with competitor comparisons
• Start the actual LLC formation process
• Track formation status and ongoing compliance requirements

Instead of navigating formation websites manually, just tell your AI assistant what you need and it handles the rest.

Installation

One command -- no signup required to explore:

npx @sedes/mcp-server

Or install globally:

npm install -g @sedes/mcp-server

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "sedes": {
      "command": "npx",
      "args": ["@sedes/mcp-server"],
      "env": {
        "SEDES_API_KEY": "your-api-key-here"
      }
    }
  }
}

ChatGPT

Use the MCP plugin configuration in ChatGPT settings:

{
  "name": "sedes",
  "command": "npx",
  "args": ["@sedes/mcp-server"],
  "env": {
    "SEDES_API_KEY": "your-api-key-here"
  }
}

Gemini

Add to your Gemini MCP configuration:

{
  "mcpServers": {
    "sedes": {
      "command": "npx",
      "args": ["@sedes/mcp-server"],
      "env": {
        "SEDES_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SEDES_API_KEY | Yes | -- | Your Sedes API key (get one here) | | SEDES_API_URL | No | https://sedesra.com/api/v1 | API base URL |

Idempotency Contract (read this first)

Every write tool requires a client-provided idempotency_key. This is a first-class API contract, not an optional optimization. It exists because the write tools have real-money side effects (state filings, registered-agent purchases, $300+ fees) and LLM clients routinely retry on timeout. Without an idempotency key, a retry would double-file the LLC and double-charge the user.

Rules:

1. Generate a fresh UUID v4 (or any deterministic string) once per logical user intent. Persist it in your conversation state.
2. Pass the same key on every retry of the same request. The backend will return the original response and will not re-execute the side effect.
3. Use a new key when the user intends a new formation. Reusing a key with a different request body returns HTTP 409 (IDEMPOTENCY_CONFLICT).
4. The key is scoped per authenticated caller, so cross-user collisions are impossible. Cached records are retained for 7 days before TTL eviction.

Tools that require an idempotency key:

| Tool | Required? | Reason | |-----------------------|-----------|-------------------------------------------------| | start_llc_formation | Yes | Initiates real state filing + creates an order. |

All other tools (check_business_name, recommend_formation_state, get_formation_quote, check_formation_status, get_state_llc_info, get_compliance_requirements) are read-only and do not require a key.

If a write tool is called without an idempotency key, the backend returns HTTP 400 with error.code = "IDEMPOTENCY_KEY_REQUIRED" before any side effect runs.

Tools Reference

check_business_name

Check if a business name is available for LLC formation in a specific US state.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | name | string | Yes | The desired business name | | state | string | Yes | 2-letter US state code (e.g., "WY", "DE") |

Example response:

{
  "available": true,
  "name": "Pixel Perfect Design LLC",
  "state": "WY",
  "similarNames": ["Pixel Perfect LLC", "Perfect Design LLC"],
  "reservationUrl": "https://sedesra.com/reserve/..."
}

recommend_formation_state

Get an AI-powered recommendation for the best US state to form your LLC based on business type, privacy needs, and budget.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | businessType | string | Yes | Type of business (e.g., "e-commerce", "consulting") | | homeState | string | No | 2-letter code of your home state | | privacyLevel | enum | Yes | standard, privacy, or anonymous | | budget | enum | Yes | low, medium, or high | | entityType | string | No | Default: "llc" |

Example response:

{
  "recommended": "WY",
  "reasons": [
    "No state income tax",
    "Strong privacy protections -- no public member disclosure",
    "Low annual report fee ($60)",
    "Lifetime proxy officers available"
  ],
  "alternatives": [
    {"state": "NM", "reason": "No annual report required"},
    {"state": "DE", "reason": "Business-friendly court system"}
  ]
}

get_formation_quote

Get a detailed, transparent price quote for LLC formation. Includes line-item breakdown and competitor comparison.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | state | string | Yes | 2-letter US state code | | entityType | string | No | Default: "llc" | | addOns | string[] | No | e.g., ["ein", "operating_agreement", "boi_report"] |

Example response:

{
  "state": "WY",
  "total": 129,
  "breakdown": {
    "stateFee": 100,
    "sedesServiceFee": 29,
    "registeredAgent": 0,
    "ein": 0
  },
  "competitors": {
    "legalzoom": 378,
    "zenbusiness": 199,
    "incfile": 149
  },
  "included": ["Registered agent (1 year)", "EIN filing", "Operating agreement template"]
}

start_llc_formation

Start the LLC formation process. Returns a secure payment link. This initiates a real legal filing.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | state | string | Yes | 2-letter state code | | businessName | string | Yes | Full name including designator (e.g., "Acme LLC") | | managementType | enum | Yes | member_managed or manager_managed | | members | array | Yes | [{name, title, ownershipPercent}] | | privacyLevel | enum | Yes | standard, privacy, or anonymous | | idempotency_key | string | Yes | UUID v4 (or any unique string) for this logical request. Retries with the same key return the original response without re-filing. See Idempotency Contract. | | entityType | string | No | Default: "llc" | | purpose | string | No | Business purpose statement |

check_formation_status

Check the current status of an LLC formation order.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | formationId | string | Yes | The formation ID from start_llc_formation |

Example response:

{
  "formationId": "fm_abc123",
  "status": "filed",
  "state": "WY",
  "businessName": "Acme LLC",
  "filedDate": "2026-04-07",
  "estimatedCompletion": "2026-04-14",
  "documents": ["Articles of Organization", "EIN Confirmation"]
}

get_state_llc_info

Get detailed information about LLC formation in a specific state -- fees, privacy features, requirements, pros and cons.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | state | string | Yes | 2-letter code or full state name |

get_compliance_requirements

Get all ongoing compliance requirements (annual reports, taxes, registered agent) for an LLC in a specific state.

Parameters: | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | state | string | Yes | 2-letter state code | | entityType | string | No | Default: "llc" |

Example Conversations

"I want to form an LLC"

You: I want to start an LLC for my freelance design business. I'm based in California but want privacy.

AI calls recommend_formation_state with {businessType: "freelance design", homeState: "CA", privacyLevel: "anonymous", budget: "medium"} and recommends Wyoming for its privacy protections and no state income tax. Then calls get_formation_quote to show you'll pay $129 total ($100 state fee + $29 Sedes fee) with registered agent and EIN included free.

"Is my business name available?"

You: Can I name my company "Pixel Perfect Design LLC" in Wyoming?

AI calls check_business_name with {name: "Pixel Perfect Design LLC", state: "WY"} and confirms the name is available, with a list of similar names already registered.

"How much does it cost?"

You: What's the total cost to form an LLC in Delaware?

AI calls get_formation_quote with {state: "DE"} and presents a full line-item breakdown. Shows Sedes at $119 total vs LegalZoom at $378 and ZenBusiness at $199.

"What do I need to do after forming?"

You: What are the ongoing requirements for a Wyoming LLC?

AI calls get_compliance_requirements with {state: "WY"} and lists the $60 annual report due every year, plus franchise tax details and registered agent requirements.

Why Sedes?

• $29 all-in service fee -- competitors charge $79-$299 for the same filing
• Free EIN filing -- included with every formation, not a $79 add-on
• All 50 states -- form in any state with real-time name availability checks
• AI-native -- built from day one for AI assistants, not retrofitted
• Transparent pricing -- see exact state fees + our fee, no surprise charges
• Free registered agent -- first year included, $49/year after

Links

• Sedes Homepage
• API Documentation
• Pricing
• Privacy Policy
• Terms of Service

License

MIT