Central Fox Tecnologia LTDA MCP API
The mcp API from Central Fox Tecnologia LTDA — 1 operation(s) for mcp.
The mcp API from Central Fox Tecnologia LTDA — 1 operation(s) for mcp.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/foxnfe-com-br:foxnfe-com-br-mcp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: FOX NF-e MCP API
version: '1.20260923'
description: Contrato derivado das rotas, regras Laravel e respostas estáticas. Condições de validação são descritas nos campos. x-source identifica a evidência. Valores dinâmicos sem tipo comprovado não recebem tipos inventados.
servers:
- url: https://www.foxnfe.com.br
tags:
- name: MCP
paths:
/api/v1/mcp:
get:
operationId: get_api_v1_mcp
tags:
- MCP
summary: Mcp discover
x-source:
- app/routes/api.php:340-342
- app/app/Modules/Mcp/Http/Controllers/McpController.php:82-99
x-middleware:
- api
- throttle:60,1
responses:
'200':
description: Metadados públicos de discovery MCP.
content:
application/json:
schema:
type: object
required:
- service
- endpoint
- protocol
- methods
- authentication
- tools
- docs
properties:
service:
type: string
example: FOX NF-e
endpoint:
type: string
format: uri
protocol:
type: string
methods:
type: array
items:
type: string
enum:
- POST
- DELETE
authentication:
type: object
additionalProperties:
type: string
tools:
type: integer
minimum: 0
docs:
type: string
format: uri
examples:
estrutura_ficticia:
summary: Exemplo estrutural fictício; não é recibo de execução.
description: Dados sintéticos para explicar o formato. Identificadores, cadastros fiscais, arquivos e regras de domínio devem ser substituídos por valores válidos do ambiente de homologação. Este exemplo não comprova aceitação fiscal.
value:
service: FOX NF-e
endpoint: https://example.invalid/callback
protocol: EXEMPLO_FICTICIO
methods:
- POST
authentication: {}
tools: 1
docs: https://example.invalid/callback
'405':
description: SSE via GET não é oferecido.
headers:
Allow:
schema:
type: string
example: POST, DELETE
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
example: SSE GET is not offered
examples:
estrutura_ficticia:
summary: Exemplo estrutural fictício; não é recibo de execução.
description: Dados sintéticos para explicar o formato. Identificadores, cadastros fiscais, arquivos e regras de domínio devem ser substituídos por valores válidos do ambiente de homologação. Este exemplo não comprova aceitação fiscal.
value:
error: SSE GET is not offered
'429':
description: Limite de requisições excedido.
description: Discovery público do transporte MCP. Retorna metadados para navegador e catálogo. Requisições que pedem text/event-stream recebem 405 porque SSE GET não é oferecido.
parameters:
- name: Accept
in: header
required: false
description: Se contiver text/event-stream, o servidor rejeita com 405.
schema:
type: string
post:
operationId: post_api_v1_mcp
tags:
- MCP
summary: Mcp handle
x-source:
- app/routes/api.php:344-348
- app/app/Modules/Mcp/Http/Controllers/McpController.php:117-160
- app/app/Modules/Mcp/Http/Controllers/McpController.php:169-218
x-middleware:
- api
- auth:sanctum
- throttle:120,1
- tenant.identify
- tenant.status
- plan.limits
- mcp.fiscal.readonly
responses:
'200':
description: Resposta JSON-RPC única ou lote de respostas. Erros de método/parâmetros também usam envelope JSON-RPC com HTTP 200.
headers:
Mcp-Session-Id:
description: Identificador de sessão recebido ou gerado pelo servidor.
schema:
type: string
content:
application/json:
schema:
oneOf:
- type: object
required:
- jsonrpc
- id
additionalProperties: true
properties:
jsonrpc:
type: string
example: '2.0'
id: {}
result: {}
error:
type: object
required:
- code
- message
additionalProperties: true
properties:
code:
type: integer
message:
type: string
data: {}
- type: array
items:
type: object
required:
- jsonrpc
- id
additionalProperties: true
properties:
jsonrpc:
type: string
example: '2.0'
id: {}
result: {}
error:
type: object
required:
- code
- message
additionalProperties: true
properties:
code:
type: integer
message:
type: string
data: {}
examples:
estrutura_ficticia:
summary: Exemplo estrutural fictício; não é recibo de execução.
description: Dados sintéticos para explicar o formato. Identificadores, cadastros fiscais, arquivos e regras de domínio devem ser substituídos por valores válidos do ambiente de homologação. Este exemplo não comprova aceitação fiscal.
value:
jsonrpc: '2.0'
id: null
'202':
description: Notificação JSON-RPC sem id; não há resultado JSON-RPC.
'400':
description: Versão MCP não suportada ou initialize enviado com uma sessão existente.
'401':
description: Token Sanctum ausente ou inválido.
'403':
description: Origin, tenant, plano ou política MCP não permite a operação.
'404':
description: Mcp-Session-Id não encontrado ou não vinculado ao usuário e tenant autenticados.
'429':
description: Limite de requisições excedido.
security:
- bearerAuth: []
description: Transporte MCP Streamable HTTP autenticado. Aceita uma mensagem JSON-RPC 2.0 ou um lote. initialize cria sessão vinculada ao usuário e tenant; chamadas posteriores podem informar Mcp-Session-Id. Respostas de métodos são dinâmicas; notificações sem id retornam 202.
parameters:
- name: Mcp-Session-Id
in: header
required: false
description: Sessão previamente emitida por initialize. initialize exige ausência deste header; outras chamadas validam seu vínculo com usuário e tenant.
schema:
type: string
- name: MCP-Protocol-Version
in: header
required: false
description: Quando informado, deve ser 2025-06-18.
schema:
type: string
enum:
- '2025-06-18'
- name: Origin
in: header
required: false
description: Quando informado, deve pertencer à lista de origens FoxNFe aceita pelo controlador.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
required:
- method
additionalProperties: true
properties:
jsonrpc:
type: string
example: '2.0'
id: {}
method:
type: string
params:
type: object
additionalProperties: true
- type: array
minItems: 1
items:
type: object
required:
- method
additionalProperties: true
properties:
jsonrpc:
type: string
example: '2.0'
id: {}
method:
type: string
params:
type: object
additionalProperties: true
examples:
ping:
value:
jsonrpc: '2.0'
id: 1
method: ping
params: {}
initialize:
value:
jsonrpc: '2.0'
id: 1
method: initialize
params:
protocolVersion: '2025-06-18'
clientInfo:
name: cliente
version: '1.0'
delete:
operationId: delete_api_v1_mcp
tags:
- MCP
summary: Mcp destroy
x-source:
- app/routes/api.php:350-352
- app/app/Modules/Mcp/Http/Controllers/McpController.php:101-115
x-middleware:
- api
- auth:sanctum
responses:
'204':
description: Sessão encontrada e removida; sem corpo.
'401':
description: Token Sanctum ausente ou inválido.
'404':
description: Header ausente, sessão inexistente ou sessão pertencente a outro usuário/tenant.
security:
- bearerAuth: []
description: Encerra uma sessão MCP válida vinculada ao usuário autenticado e remove seu estado do cache.
parameters:
- name: Mcp-Session-Id
in: header
required: true
description: Identificador da sessão a encerrar. Deve existir e pertencer ao usuário autenticado.
schema:
type: string
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer