# Fiscalisto API docs

> Fiscalisto API docs is a free MCP server for finance and payments. Docs server for Mexican CFDI 4.0 e-invoicing, so coding agents can write the integration. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://fiscalisto.com/docs/api/agentes
- **MCP Registry name:** com.fiscalisto/docs
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-14

## About

This is the documentation server for Fiscalisto's Mexican e-invoicing API. It needs no key or account: a coding agent connects to the address https://fiscalisto.com/docs/api/mcp, searches the guides in Spanish or English, reads reference pages and gets SDK code per operation. Setup snippets are given for Cursor, VS Code, Claude Code, Codex and Claude on the web and desktop.

Its tools include a one-page integration guide the agent asks for first, a lookup that explains an error code, and a call tool that sends a real request in test mode. That tool only accepts a test key starting `fk_test_` and never a live key; its requests show up under Developers, Requests in the Fiscalisto dashboard.

Around the server the site offers a Fiscalisto CLI whose `init --agents` writes an AGENTS.md section and a skill file, a local mock API on 127.0.0.1:12111 that does not check SAT rules, an OpenAPI 3.1 document, llms.txt and per-page Markdown. The guidance steers generated code toward the official SDK, an Idempotency-Key per invoice, customer data as the SAT requires and verified webhooks. Pricing for the invoicing API itself is not on this page.

## Features

- **Searchable docs:** Searches guides and reference pages in Spanish or English and reads or lists any page.
- **Operation lookup:** Describes an operation with its fields and SDK code in the language you pick.
- **Error explanations:** Explains what an error code means and how to resolve it.
- **Test-mode requests:** Sends real requests with an fk_test_ key and returns the code, Request-Id and JSON.
- **One-page agent guide:** The same integration skill is available as SKILL.md and from the get_started tool.
- **Local mock API:** The CLI starts a mock server so tests can run without internet.

## Good for

- Ask a coding agent to add CFDI invoicing to an order flow
- Look up the fields of an Invoice object while coding
- Debug a SAT rejection by asking what an error code means
- Try an invoice stamp in test mode from the editor

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http docs https://fiscalisto.com/docs/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://fiscalisto.com/docs/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "docs": {
      "url": "https://fiscalisto.com/docs/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "docs": {
      "type": "http",
      "url": "https://fiscalisto.com/docs/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "docs": {
      "serverUrl": "https://fiscalisto.com/docs/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "docs": {
      "type": "http",
      "url": "https://fiscalisto.com/docs/api/mcp"
    }
  }
}
```

## Tools

- `get_started`: Returns the full integration guide on one page; agents ask for it first.
- `search_docs`: Searches guides and reference in Spanish or English.
- `get_page`: Reads one full documentation page.
- `list_pages`: Lists all documentation pages.
- `list_operations`: Lists each operation with operationId, method and path by section.
- `describe_operation`: Describes one operation with its fields and SDK code in the chosen language.
- `describe_object`: Shows the fields of an object such as Invoice or Event with an example.
- `explain_error`: Explains an error.code and how to resolve it.
- `call_api`: Sends a real test-mode request with an fk_test_ key and returns the code, Request-Id and JSON.

## FAQ

### Does the docs server need an API key?

No. The MCP address works without a key or account.

### Can the agent stamp real invoices through it?

No. call_api only accepts test keys (fk_test_) and never a live fk_live_ key.

### Which clients are covered?

The page gives setup for Cursor, VS Code, Claude Code, Codex and Claude web and desktop, plus any streamable HTTP client.

### Is there a machine-readable spec?

Yes, an OpenAPI 3.1 document without a key, plus llms.txt, llms-full.txt and Markdown versions of each page.

### Is Fiscalisto API docs free?

Yes. Fiscalisto API docs is free to use.

### How do I add Fiscalisto API docs to Claude Code?

Run this command in your terminal: claude mcp add --transport http docs https://fiscalisto.com/docs/api/mcp

### What are the best alternatives to Fiscalisto API docs?

The closest alternatives to Fiscalisto API docs are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/fiscalisto-api-docs
