# incorporations.io

> incorporations.io is a free jurisdiction comparison tool for international
> company formation. It compares offshore and onshore jurisdictions across tax
> rates, entity types, privacy, legal basis, compliance requirements and tax
> treaties. It is operated by Flag Theory (https://flagtheory.com), an
> internationalization and offshore solutions provider that handles the actual
> incorporation and bank account opening.

## What this site is

- A comparison and research tool, not a checkout. Pricing shown is indicative;
  Flag Theory confirms final scope, pricing and eligibility before any order.
- Covers four entity types: `corporation`, `llc`, `foundation`, `trust`.
- Each "jurisdiction" in the API is a specific entity program in a country
  (identified by a `code`, the Company code). One country may offer several
  programs (e.g. a corporation and an LLC).

## Data model

Each jurisdiction exposes:
- Identity: `code`, `countryCode`, `country`, `region`, `entityType`,
  `legalEntity`, `acronym`, `legalBasis`.
- Tags: `goodFor` (use-case tags such as trading, holding, crypto, privacy).
- Tax: corporate / offshore / personal / capital-gains / VAT / withholding
  rates, plus CFC rules and offshore exemptions. Rates are returned as
  `{ value, raw }` where `value` is a number (percent) or null when unknown.
- Features: directors/shareholders rules, secretary, audit, annual return,
  redomiciliation, exchange controls.
- Privacy: which roles are kept off public registries (varies by entity type).
- Price: `{ amount, currency, raw }` (indicative), plus `links.shop`.

## REST API

Base URL: https://incorporations.io/api/v1
Full OpenAPI 3.0 spec: https://incorporations.io/openapi.json
Format: JSON. Success: `{ "data": ..., "meta"?: ... }`. Error:
`{ "error": { "code", "message", "details"? } }`.

Read endpoints (open):
- `GET /api/v1/jurisdictions` — search/filter. Query params: `entity_type`,
  `good_for` (csv), `legal_basis`, `region`, `tax_rate_max`, `cfc` (bool),
  `privacy` (bool), `q` (text), `sort` (`region`|`tax_rate`|`price`, prefix `-`
  to reverse), `limit`, `offset`.
- `GET /api/v1/jurisdictions/:code` — full detail for one jurisdiction.
- `GET /api/v1/jurisdictions/compare?codes=a,b,c` — side-by-side (2–6 codes).
- `GET /api/v1/filters` — available filter values (entity types, good-for tags,
  legal bases, regions, corporate tax-rate range).
- `GET /api/v1/quote?jurisdiction=<code>&entity_type=<type>` — indicative price
  and external checkout link. Informational only; no payment.

Write endpoints (require an API key via `Authorization: Bearer <key>` or
`X-API-Key`):
- `POST /api/v1/inquiries` — body `{ name, email, jurisdiction?, entity_type?,
  message? }`. Persists the lead and forwards it to Flag Theory.
- `POST /api/v1/orders` — body `{ type: "incorporation"|"bank_account",
  jurisdiction?, entity_type?, notes?, contact: { name, email, phone?,
  citizen_of?, resident_of? } }`. Creates a DRAFT order and returns an opaque
  `token`. No payment is processed.
- `GET /api/v1/orders/:id?token=<token>` — order status (readable with the
  order token or an API key).

## MCP server

The API is also exposed via the Model Context Protocol so AI agents can call it
natively. Tools mirror the endpoints: `search_jurisdictions`,
`get_jurisdiction`, `compare_jurisdictions`, `list_filters`, `get_quote`,
`submit_inquiry`, `create_order`, `get_order_status`.

- Hosted (Streamable HTTP): `https://incorporations.io/mcp` — POST JSON-RPC
  (JSON or SSE responses), GET for the SSE stream. Write tools require an API
  key via `Authorization: Bearer <key>`.
- Standalone (stdio) package for local agents — see the project README.

## Key pages

- https://incorporations.io/ — corporations & LLCs comparison
- https://incorporations.io/foundations
- https://incorporations.io/trusts
- https://incorporations.io/sitemap.xml

## Contact

For incorporation and banking services: https://flagtheory.com