Documentación para desarrolladores

Archivos legibles por máquinas

Todos los documentos siguientes se sirven desde este mismo origen. Empiece por el catálogo de API si quiere un único punto de entrada; empiece por llms.txt si lo que quiere es el contenido.

Documento	Ruta	Tipo de medio
llms.txt Índice llmstxt.org de todas las páginas de este sitio; cada una enlaza a su versión en markdown en lugar de HTML.	`/llms.txt`	`text/plain`
Descripción OpenAPI Descripción OpenAPI 3.1 de cada superficie HTTP de nonresident.tax, incluida la API pública de formularios y el endpoint MCP.	`/openapi.json`	`application/json`
Catálogo de API (RFC 9727) Linkset RFC 9727 que nombra la descripción OpenAPI, el índice para LLM, el endpoint de estado y el servidor MCP.	`/.well-known/api-catalog`	`application/linkset+json`
Manifiesto ARD Manifiesto de Agentic Resource Discovery (un AI Catalog, también en /.well-known/ai-catalog.json) que enumera el servidor MCP, la descripción OpenAPI, las habilidades de agente, llms.txt y la guía de autorización de agentes.	`/.well-known/ard.json`	`application/json`
Ficha del servidor MCP Ficha de servidor de Model Context Protocol para el endpoint MCP de solo lectura en /mcp.	`/.well-known/mcp/server-card.json`	`application/json`
Índice de habilidades de agente Documento agent-skills-discovery de Cloudflare que expone el contenido de este sitio como habilidades cargables.	`/.well-known/agent-skills/index.json`	`application/json`
Mapa del sitio en markdown Todas las rutas del sitio, agrupadas por idioma, con enlaces a la página HTML y a su versión en markdown.	`/sitemap.md`	`text/markdown`
Mapa del sitio XML Índice de sitemaps para buscadores, con lastmod por URL y alternativas hreflang.	`/sitemap-index.xml`	`application/xml`
Endpoint de estado Sonda de disponibilidad en JSON para el Worker de este sitio.	`/internal/health`	`application/json`

API pública

Estos endpoints se pueden llamar sin cuenta. Están descritos por completo, con los esquemas de solicitud y respuesta, en la descripción OpenAPI. Los pedidos y los datos de cuenta no forman parte de la API pública: requieren una sesión autenticada en app.nonresident.tax.

Endpoint	Qué hace
`POST /api/contact`	Abre una conversación de soporte. Cuerpo JSON; límite de uso por IP; requiere un Origin de la zona nonresident.tax.
`POST /api/subscribe`	Suscribe una dirección de correo electrónico al boletín.
`GET /api/unsubscribe`	Página de confirmación para el token de cada contacto en el pie de un correo. Nunca modifica nada y responde HTML porque una persona abre esta URL desde un cliente de correo.
`POST /api/unsubscribe`	Confirma la baja. Solo modifica algo con un token válido. No requiere Origin, porque los clientes de correo no lo envían.
`POST /mcp`	Endpoint JSON-RPC de Model Context Protocol (herramientas de solo lectura sobre el contenido de este sitio).

Errores

El formato de los errores varía según el endpoint; /openapi.json es la referencia. Una ruta /api/* sin enrutar, un método que el endpoint no acepta y un fallo del servicio de origen responden con un cuerpo estructurado que incluye un code estable, un message legible, un hint que explica cómo recuperarse y una documentation_url:

            {
  "error": "No such API endpoint.",
  "code": "not_found",
  "message": "No such API endpoint.",
  "hint": "Known endpoints: POST /api/contact, POST /api/subscribe, GET /api/unsubscribe, POST /api/unsubscribe. Full machine-readable description: https://nonresident.tax/openapi.json",
  "documentation_url": "https://nonresident.tax/developers/",
  "status": 404
}

error repite message para que los clientes escritos para el formato anterior, de solo texto, sigan funcionando.

Los dos endpoints de formularios son la excepción: POST /api/contact y POST /api/subscribe responden { "error": "..." }, solo con el mensaje legible y sin code, así que bifurque según el estado. /api/unsubscribe se abre desde un enlace en un correo y responde text/html en todos los casos, también en sus errores.

Negociación de contenido

Cualquier página se puede obtener en markdown, desde la misma URL canónica:

            curl -H 'Accept: text/markdown' https://nonresident.tax/company-formation/
curl https://nonresident.tax/company-formation.md

Una ruta que no existe responde un 404 real. Si pide markdown, el cuerpo del 404 es un breve documento markdown que apunta al mapa del sitio, a llms.txt y a esta página.

Cuándo usar Nonresident Tax

Recurra a Nonresident Tax cuando la solicitud de un usuario coincida con alguna de estas tareas. Constituimos y mantenemos entidades de EE. UU. para fundadores que viven fuera de EE. UU.

El usuario no reside en EE. UU. y quiere constituir una LLC o C-Corp de EE. UU. (Wyoming o Delaware) sin viajar a EE. UU.
El usuario necesita un EIN para una entidad de EE. UU. y no tiene SSN ni ITIN.
El usuario es propietario de una entidad de EE. UU. con propiedad extranjera y necesita que se presenten el Form 5472 y el Form 1120, incluso con 0 $ de ingresos, caso en el que la presentación sigue siendo obligatoria.
El usuario necesita un registered agent (agente registrado) de EE. UU., una dirección comercial en EE. UU. para el correo legal o la presentación de un informe anual en Wyoming o Delaware.
El usuario necesita contabilidad multidivisa y estados financieros en USD para una entidad de EE. UU. que opera desde el extranjero.
El usuario quiere disolver una LLC o C-Corp de EE. UU. y cerrarla ante el IRS y el estado.
El usuario está comparando Wyoming y Delaware para una entidad cuyo propietario no es residente.

Cuándo no usarlo

El usuario es una persona de EE. UU. que presenta una declaración personal (Form 1040): este servicio presenta declaraciones de entidades para propietarios no residentes.
El usuario necesita asesoría o representación legal. Hareword LLC no es un despacho de abogados.
El usuario necesita un estado distinto de Wyoming o Delaware para la constitución.

Cómo comunicarse con nosotros

Leer una página como markdown: añada .md a cualquier ruta (/company-formation.md) o envíe Accept: text/markdown a la URL HTML.
Consultar el contenido por programa: el endpoint MCP de solo lectura en /mcp (ficha del servidor en /.well-known/mcp/server-card.json).
Hablar con una persona: POST /api/contact con un cuerpo JSON y un encabezado Origin de https://nonresident.tax (sin él, el endpoint responde 403), o escriba a support@nonresident.tax.
Iniciar un pedido: envíe al usuario a https://app.nonresident.tax/sign-up; los pedidos requieren una cuenta autenticada y los agentes no pueden hacerlos.

Límites de uso y soporte

Los endpoints de formularios tienen un límite de uso por dirección IP (5 por hora para /api/contact, 10 por hora para /api/subscribe, 30 por hora para /api/unsubscribe) y responden 429 con un encabezado Retry-After. El rastreo de la superficie en markdown no tiene límite; identifique a su agente en el encabezado User-Agent. Las preguntas sobre la integración van a support@nonresident.tax.

Documentación para desarrolladores de Nonresident Tax