# DAS Payment Scheduler MCP

> DAS Payment Scheduler manages Brazilian Simples Nacional tax payments automatically. It generates an annual calendar, calculating precise deadlines by adjusting for national holidays and weekends. Need to know if your payment date shifted because of a bank holiday? Or find out which taxes are already late? This tool handles the complex rules so you don't get hit with penalties.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** brazil, simples-nacional, das, tax-calendar, accounting, automation

## Description

Managing Brazilian tax compliance shouldn't feel like an academic exercise in calendar theory. The DAS Payment Scheduler is built for entrepreneurs who need to keep up with their Simples Nacional obligations without manual headache. It automatically calculates your required payment deadlines, adjusting the standard 20th of the month if it falls on a weekend or federal holiday. This means you get accurate dates every single time.

Want to see your entire tax year laid out? Use this MCP's core function to view an annual plan at a glance. If you ever wonder why a payment date moved, there’s a specific check to trace the exact reason—whether it was a weekend or a holiday. And if you just need to know where you stand right now, another tool flags any months where the deadline has already passed. It’s this level of specialized compliance that makes Vinkius the go-to place for running complex tools like this.

## Tools

### generate_annual_schedule
Maps out every required DAS payment date for an entire fiscal year.

### inspect_holiday_impact
Shows exactly why a specific tax payment was moved, pointing to holidays or weekends.

### identify_overdue_periods
Checks the current date and flags any months where the DAS payment deadline has already passed.

## Prompt Examples

**Prompt:** 
```
Show me my DAS payment schedule for 2024.
```

**Response:** 
```
Here is your DAS payment schedule for 2024. The first payment (competence January) is due on 2024-02-20, and all subsequent months follow the standard 20th rule unless adjusted for holidays.
```

**Prompt:** 
```
Are there any overdue DAS payments as of today (2024-05-15)?
```

**Response:** 
```
As of 2024-05-15, the following periods are overdue: January (deadline was 2024-02-20), February (deadline was 2024-03-20), and March (deadline was 2024-04-20).
```

**Prompt:** 
```
Why was the May 20th payment date moved in 2024?
```

**Response:** 
```
The payment for May 2024 remains on 2024-05-20 as there are no national holidays or weekends interfering with this specific date.
```

## Capabilities

### Generate Annual Payment Calendar
Builds a full, year-long payment schedule for all required DAS contributions.

### Trace Date Shifts
Determines if a specific tax deadline was moved due to national holidays or weekends.

### Identify Late Payments
Flags any months where the required tax payment deadline has already passed.

## Use Cases

### The Annual Planning Check
A consultant needs to draft tax advice for a client starting fresh. They run generate_annual_schedule to get the full picture, ensuring they account for every single payment date across 12 months.

### Urgent Overdue Audit
A business owner is worried about tax penalties today. They immediately call identify_overdue_periods to get a list of all missed deadlines, letting them know exactly what needs paying right away.

### Investigating a Date Change
The client noticed the May 20th payment date was different from last year. They use inspect_holiday_impact to confirm that no national holiday affected this specific month, giving them peace of mind.

## Benefits

- Never miss a payment because of an unannounced federal holiday. The system calculates shifts automatically based on Brazilian law.
- Get immediate status checks using identify_overdue_periods to see exactly which months are late right now.
- Stop guessing about compliance: use generate_annual_schedule to view your entire tax year plan in one place.
- When a date changes, you need to know why. inspect_holiday_impact gives clear reasons—weekend or holiday—every time.
- Saves hours of manual spreadsheet work that would otherwise be spent cross-referencing calendars and government rules.

## How It Works

The bottom line is you get a reliable tax calendar that accounts for local regulatory shifts, saving you from manual calculation errors.

1. Input the year you need to plan for or check compliance against.
2. The MCP calculates all standard deadlines, then cross-references them with Brazilian national holidays and weekends, adjusting dates as required by law.
3. You receive a clear schedule showing both future payments and any immediate overdue periods.

## Frequently Asked Questions

**How does generate_annual_schedule work for my taxes?**
It generates a full payment timeline for the Simples Nacional DAS contributions across all 12 months. It shows you exactly what's due and when, so you can plan ahead.

**What if I need to know why my tax date changed? Use inspect_holiday_impact.**
The inspect_holiday_impact tool tells you the exact reason for a date shift. It specifies whether the change was due to a weekend or a national holiday.

**How can I check if any payments are late right now? Use identify_overdue_periods.**
identify_overdue_periods checks against today's date and immediately flags every tax period that has passed its deadline. It keeps you compliant, fast.

**Does the DAS Payment Scheduler handle yearly changes?**
Yes. You can use generate_annual_schedule to view a full year’s plan, which accounts for standard shifts and predictable holidays throughout that period.

**What input years does `generate_annual_schedule` require?**
It requires a defined start and end year range. You specify these parameters to ensure the schedule covers exactly the tax periods you need, preventing gaps or unnecessary calculations.

**Can `identify_overdue_periods` handle future dates?**
No, this tool only identifies deadlines that have already passed. If you check a month that hasn't reached its deadline yet, it will return an empty list and confirm the period is current.

**Are there usage limits when I call `inspect_holiday_impact`?**
No specific rate limits are published for this MCP. However, running a very high volume of calls in quick succession may cause your agent to pause briefly to manage the API requests efficiently.

**Is this DAS Payment Scheduler limited only to Simples Nacional taxes?**
Yes. The service is built specifically for Brazilian entrepreneurs operating under the Simples Nacional tax regime. It does not calculate or track payments from other tax frameworks.