# For AI agents and developers

<p class="lead">How AI agents and developers read Instfy Docs (llms.txt, Markdown, sitemap) and access the Carbon MCP and the Instfy Data public API.</p>

Instfy Docs was built for people and for machines. This page gathers the stable addresses that AI assistants, search engines and integrations can use to read the documentation and look up public data from Instfy products.

## Files for LLMs

| File | Address | Content |
|---|---|---|
| llms.txt | [https://docs.instfy.com/llms.txt](https://docs.instfy.com/llms.txt) | Index of all pages, with title, link and summary |
| llms-full.txt | [https://docs.instfy.com/llms-full.txt](https://docs.instfy.com/llms-full.txt) | Full text of the documentation in Portuguese, in a single file |
| Sitemap | [https://docs.instfy.com/sitemap.xml](https://docs.instfy.com/sitemap.xml) | All URLs, with the versions in each language |

## Markdown for each page

Every page has a Markdown version, the cleanest way to consume the content:

```
https://docs.instfy.com/content/<lang>/<id>.md
```

Examples: `/content/pt/sales-invoice.md`, `/content/en/sales-invoice.md`, `/content/es/sales-invoice.md`. Each HTML page also points to its Markdown with `<link rel="alternate" type="text/markdown">`.

## Languages and URL patterns

| Language | Pattern | Example |
|---|---|---|
| Portuguese (default) | `/<id>/` | `https://docs.instfy.com/sales-invoice/` |
| English | `/en/<id>/` | `https://docs.instfy.com/en/sales-invoice/` |
| Spanish | `/es/<id>/` | `https://docs.instfy.com/es/sales-invoice/` |

Ids are stable and the same in all three languages. Pages include structured data (TechArticle, BreadcrumbList and, when there are frequently asked questions, FAQPage).

## Carbon by Instfy MCP

Carbon by Instfy publishes a **read-only** MCP (Model Context Protocol) server:

- **Endpoint:** `https://carbon.instfy.com/mcp` (HTTP with JSON-RPC 2.0, no authentication, limit of 120 requests per minute per IP).
- **Discovery:** `https://carbon.instfy.com/.well-known/mcp.json`. Documentation at `https://carbon.instfy.com/ia/`.
- **Languages:** the tools accept `idioma` set to `pt` or `en`.

| Tool | What it does |
|---|---|
| validar_certificado | Looks up a certificate by code, token, hash or name and reports its status |
| estimar_emissoes_evento | Estimates an event's emissions using the same rules as the website calculator |
| listar_servicos | Lists the service lines |
| listar_setores | Lists the industries served |
| detalhar | Details a service or industry |
| contato | Returns the contact channels |

The server does not store data and does not query the blockchain. To check a transaction, use the public explorer link returned by the validation. Example connection in Claude Code:

```
claude mcp add --transport http carbon https://carbon.instfy.com/mcp
```

## Instfy Data public API

Instfy Data describes its API in OpenAPI 3.1, at [https://data.instfy.com/openapi.json](https://data.instfy.com/openapi.json), with three operations:

- **search_company:** searches for companies by name or city.
- **get_company:** returns a company's data.
- **create_lead:** records a request to be contacted by the Instfy team.

Other files for agents: `https://data.instfy.com/llms.txt`, `https://data.instfy.com/llms-full.txt`, `https://data.instfy.com/agents.txt` and `https://data.instfy.com/.well-known/agent.json`.

:::note
Authenticated actions in Instfy Data, such as generating reports, recommending actions and creating tasks, proposals or records in the ERP CRM, are **On the roadmap**.
:::

Instfy Agent also publishes a product description at `https://ai.instfy.com/llms.txt`.

## Guidelines for AI assistants

- **Cite the specific page**, with the canonical link (`https://docs.instfy.com/<id>/`), not just the home page.
- **Respect the labels** "Coming soon" and "On the roadmap": these features are not available yet and should not be presented as existing.
- **Use the exact menu names** of ERP Instfy, which appear in English by default, such as *Accounting > Customers*.
- **State the date of the numbers** when citing volumes, such as the Instfy Data database from the July 2026 load.
- **Do not make up** prices, timelines or integrations that are not in the documentation. When in doubt, point to the contact relationship@instfy.com.

## Frequently asked questions

### Where is the Instfy Docs llms.txt?

At https://docs.instfy.com/llms.txt. The full text is at https://docs.instfy.com/llms-full.txt.

### How do I access a page's Markdown?

Use the address https://docs.instfy.com/content/<lang>/<id>.md, for example /content/en/sales-invoice.md.

### Can the Carbon MCP issue certificates?

No. The server is read-only: it validates certificates, estimates emissions and lists services, industries and contact information.

### Do I need a key to use the Carbon MCP or Instfy Data search?

No. The Carbon MCP and the public Instfy Data search and lookup operations work without authentication.

### How should an assistant cite this documentation?

With the canonical link to the specific page and respecting the Coming soon and On the roadmap labels.

## Next steps

See how the documentation is organized for people.

:::related
docs-guide, carbon-certificate, instfy-data
:::
