### MCP Configuration for Feriados API

Source: https://feriadosapi.com/docs

Example of an MCP configuration file for connecting to the Feriados API. Replace 'SUA_API_KEY' with your actual API key.

```json
{
  "mcpServers": {
    "feriadosapi": {
      "url": "https://mcp.feriadosapi.com/api/mcp?apiKey=SUA_API_KEY"
    }
  }
}
```

--------------------------------

### GET /api/v1/feriados/bancarios

Source: https://feriadosapi.com/docs

Lists banking holidays for a specific year.

```APIDOC
## GET /api/v1/feriados/bancarios

### Description
Lists banking holidays for a specific year.

### Method
GET

### Endpoint
/api/v1/feriados/bancarios

### Parameters
#### Query Parameters
- **ano** (string) - Required - The year to filter.
- **uf** (string) - Optional - Filter by state.
- **ibge** (string) - Optional - Filter by IBGE code.
- **facultativos** (boolean) - Optional - Include optional holidays.

### Response
#### Success Response (200)
- **tipo** (string) - Type of holiday list.
- **ano** (string) - Year.
- **feriados** (array) - List of holiday objects.
```

--------------------------------

### GET /api/v1/municipios

Source: https://feriadosapi.com/docs

Retrieves a list of all Brazilian municipalities.

```APIDOC
## GET /api/v1/municipios

### Description
Returns the list of all 5,570 Brazilian municipalities.

### Method
GET

### Endpoint
/api/v1/municipios

### Response
#### Success Response (200)
- **municipios** (array) - List of municipality objects.
- **meta** (object) - Pagination metadata.
```

--------------------------------

### GET /api/v1/feriados/dia-util-bancario/{data}

Source: https://feriadosapi.com/docs

Verifies if a specific date is a banking business day.

```APIDOC
## GET /api/v1/feriados/dia-util-bancario/{data}

### Description
Verifies if a specific date is a banking business day. If not, returns the reason and the next business day.

### Method
GET

### Endpoint
/api/v1/feriados/dia-util-bancario/{data}

### Parameters
#### Path Parameters
- **data** (string) - Required - The date in YYYY-MM-DD format.

### Response
#### Success Response (200)
- **data** (string) - The requested date.
- **dia_util_bancario** (boolean) - Whether it is a business day.
- **motivo** (string) - Reason if not a business day.
- **proximo_dia_util** (string) - Next available business day.
```

--------------------------------

### GET /api/v1/municipio/{ibge}

Source: https://feriadosapi.com/docs

Retrieves details for a specific municipality by IBGE code.

```APIDOC
## GET /api/v1/municipio/{ibge}

### Description
Returns the data of a specific municipality by its IBGE code.

### Method
GET

### Endpoint
/api/v1/municipio/{ibge}

### Parameters
#### Path Parameters
- **ibge** (string) - Required - The IBGE code of the municipality.

### Response
#### Success Response (200)
- **ibge** (integer) - IBGE code.
- **nome** (string) - Name of the municipality.
- **uf** (string) - State UF.
```

--------------------------------

### GET /api/v1/feriados/nacionais

Source: https://feriadosapi.com/docs

Retrieves all national holidays for a specified year.

```APIDOC
## GET /api/v1/feriados/nacionais

### Description
Returns all national holidays for a given year.

### Method
GET

### Endpoint
/api/v1/feriados/nacionais

### Parameters
#### Query Parameters
- **ano** (string) - Optional - Filters holidays by year (e.g., 2026)

### Response
#### Success Response (200)
- **tipo** (string) - Holiday type
- **ano** (string) - Year
- **feriados** (array) - List of holiday objects
- **meta** (object) - Pagination metadata

### Response Example
{
  "tipo": "NACIONAL",
  "ano": "2026",
  "feriados": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "data": "01/01/2026",
      "nome": "Confraternização Universal",
      "tipo": "NACIONAL"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "per_page": 50,
    "total_pages": 1
  }
}
```

--------------------------------

### GET /api/v1/feriados/data/{ano-mes-dia}

Source: https://feriadosapi.com/docs

Retrieves holiday information for a specific date.

```APIDOC
## GET /api/v1/feriados/data/{ano-mes-dia}

### Description
Retrieves holiday information for a specific date.

### Method
GET

### Endpoint
/api/v1/feriados/data/{ano-mes-dia}

### Parameters
#### Path Parameters
- **ano-mes-dia** (string) - Required - The date in YYYY-MM-DD format.
```

--------------------------------

### GET /api/v1/feriados/estado/{uf}

Source: https://feriadosapi.com/docs

Retrieves state-specific holidays, including national holidays, for a given UF.

```APIDOC
## GET /api/v1/feriados/estado/{uf}

### Description
Returns state holidays (including national ones) for a specific UF.

### Method
GET

### Endpoint
/api/v1/feriados/estado/{uf}

### Parameters
#### Path Parameters
- **uf** (string) - Required - The state abbreviation (e.g., SP)

#### Query Parameters
- **ano** (string) - Optional - Filters holidays by year

### Response
#### Success Response (200)
- **uf** (string) - State abbreviation
- **ano** (string) - Year
- **feriados** (array) - List of holiday objects
- **meta** (object) - Pagination metadata
```

--------------------------------

### GET /api/v1/estados

Source: https://feriadosapi.com/docs

Retrieves a list of all Brazilian states (UFs).

```APIDOC
## GET /api/v1/estados

### Description
Returns the list of all Unidades Federativas (UFs) and their names.

### Method
GET

### Endpoint
/api/v1/estados

### Response
#### Success Response (200)
- **estados** (array) - List of state objects.
- **total** (integer) - Total count of states.
```

--------------------------------

### GET /api/v1/feriados/cidade/{ibge}

Source: https://feriadosapi.com/docs

Retrieves all holidays (municipal, state, and national) for a specific city using its IBGE code.

```APIDOC
## GET /api/v1/feriados/cidade/{ibge}

### Description
Returns all holidays (municipal, state, and national) for a specific city identified by its IBGE code.

### Method
GET

### Endpoint
/api/v1/feriados/cidade/{ibge}

### Parameters
#### Path Parameters
- **ibge** (integer) - Required - The IBGE code of the city

#### Query Parameters
- **ano** (string) - Optional - Filters holidays by year

### Response
#### Success Response (200)
- **cidade** (object) - City details
- **ano** (string) - Year
- **feriados** (array) - List of holiday objects
- **meta** (object) - Pagination metadata
```

--------------------------------

### Consultar Feriados Nacionais

Source: https://feriadosapi.com/docs

Recupera a lista de feriados nacionais para um ano específico.

```bash
curl -X GET "https://feriadosapi.com/api/v1/feriados/nacionais?ano=2026" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json
{
  "tipo": "NACIONAL",
  "ano": "2026",
  "feriados": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "data": "01/01/2026",
      "nome": "Confraternização Universal",
      "tipo": "NACIONAL"
    },
    {
      "id": "123e4567-e89b-12d3-a456-426614174001",
      "data": "25/12/2026",
      "nome": "Natal",
      "tipo": "NACIONAL"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "per_page": 50,
    "total_pages": 1
  }
}
```

--------------------------------

### Consultar Feriados Estaduais

Source: https://feriadosapi.com/docs

Recupera feriados estaduais e nacionais para uma UF específica.

```bash
curl -X GET "https://feriadosapi.com/api/v1/feriados/estado/SP?ano=2026" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json
{
  "uf": "SP",
  "ano": "2026",
  "feriados": [
    {
      "id": "...",
      "data": "09/07/2026",
      "nome": "Revolução Constitucionalista",
      "tipo": "ESTADUAL"
    }
    // ... feriados nacionais incluídos
  ],
  "meta": {
    "total": 15,
    "page": 1,
    "per_page": 50,
    "total_pages": 1
  }
}
```

--------------------------------

### Consultar Feriados Municipais

Source: https://feriadosapi.com/docs

Recupera feriados municipais, estaduais e nacionais para uma cidade via código IBGE.

```bash
curl -X GET "https://feriadosapi.com/api/v1/feriados/cidade/3550308?ano=2026" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json
{
  "cidade": {
    "ibge": 3550308,
    "nome": "São Paulo",
    "uf": "SP"
  },
  "ano": "2026",
  "feriados": [
    {
      "id": "...",
      "data": "25/01/2026",
      "nome": "Aniversário de São Paulo",
      "tipo": "MUNICIPAL"
    },
    {
      "id": "...",
      "data": "20/11/2026",
      "nome": "Consciência Negra",
      "tipo": "MUNICIPAL"
    }
  ],
  "meta": {
    "total": 18,
    "page": 1,
    "per_page": 50,
    "total_pages": 1
  }
}
```

--------------------------------

### Autenticação via Header

Source: https://feriadosapi.com/docs

Todas as requisições exigem o envio do token de acesso no cabeçalho Authorization.

```http
Authorization: Bearer seu_token_aqui
```

--------------------------------

### Retrieve Holiday by Date

Source: https://feriadosapi.com/docs

Fetch holiday information for a specific date using the API.

```bash
curl -X GET "https://feriadosapi.com/api/v1/feriados/data/2026-12-25" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

--------------------------------

### List Municipalities

Source: https://feriadosapi.com/docs

Retrieve a list of all Brazilian municipalities.

```bash
curl -X GET "https://feriadosapi.com/api/v1/municipios" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json
{
  "municipios": [
    {
      "ibge": "3550308",
      "nome": "São Paulo",
      "uf": "SP"
    }
  ],
  "meta": {
    "total": 5570,
    "page": 1,
    "per_page": 50,
    "total_pages": 112
  }
}
```

--------------------------------

### Search Municipality

Source: https://feriadosapi.com/docs

Retrieve details for a specific municipality using its IBGE code.

```bash
curl -X GET "https://feriadosapi.com/api/v1/municipio/3550308" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json
{
  "ibge": 3550308,
  "nome": "São Paulo",
  "uf": "SP"
}
```

--------------------------------

### List States

Source: https://feriadosapi.com/docs

Retrieve a list of all Brazilian states.

```bash
curl -X GET "https://feriadosapi.com/api/v1/estados" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json
{
  "estados": [
    {
      "uf": "RO",
      "nome": "Rondônia"
    },
    // ...
  ],
  "total": 27
}
```

--------------------------------

### List Banking Holidays

Source: https://feriadosapi.com/docs

Retrieve a list of banking holidays for a specific year.

```json
GET /api/v1/feriados/bancarios?ano=2026


// Resposta
{
  "tipo": "BANCARIO",
  "ano": "2026",
  "feriados": [
    {
      "id": 1,
      "data": "01/01/2026",
      "nome": "Confraternização Universal",
      "tipo": "NACIONAL",
      "bancario": true
    }
  ],
  "meta": { "total": 13, "page": 1, "per_page": 50, "total_pages": 1 }
}
```

--------------------------------

### Filter National Holidays by Banking Status

Source: https://feriadosapi.com/docs

Filter national holidays to include only those recognized by the banking system.

```bash
GET /api/v1/feriados/nacionais?ano=2026&bancarios=true
```

--------------------------------

### Check Banking Business Day

Source: https://feriadosapi.com/docs

Verify if a specific date is a banking business day.

```json
GET /api/v1/feriados/dia-util-bancario/2026-02-16


// Resposta
{
  "data": "2026-02-16",
  "dia_util_bancario": false,
  "motivo": "Carnaval (Segunda-feira)",
  "proximo_dia_util": "2026-02-18"
}
```

--------------------------------

### Holiday Object Model

Source: https://feriadosapi.com/docs

Schema definition for the holiday object returned by the API.

```json
{
  "id": "UUID",          // Identificador único
  "data": "DD/MM/YYYY",  // Data oficial
  "nome": "String",      // Nome do feriado
  "tipo": "Enum",        // NACIONAL | ESTADUAL | MUNICIPAL | FACULTATIVO
  "descricao": "String", // Contexto histórico
  "uf": "SP",            // (Opcional) UF do feriado
  "codigo_ibge": 12345,  // (Opcional) IBGE do mun.
  "bancario": true       // Feriado bancário (FEBRABAN)
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.