# Kinesis Shard Calculator AI Agent Connect

> Calculate optimal AWS Kinesis Data Streams shard counts and storage needs.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_7G2opOd95jScAmy5ULE64riFrlwh0GkwTlUCYL6G/ai-agent-connect
- **Tags:** aws, kinesis, streaming, data-streams, infrastructure

## Description

This MCP server provides deterministic calculations for AWS Kinesis Data Streams. It helps you determine the exact number of shards required for ingestion and consumption, estimate total storage footprint based on retention periods, and identify available Enhanced Fan-Out (EFO) slots. Use `calculate_shard_requirements` to find the minimum shard count, `calculate_storage_and_efo` for storage and EFO capacity, and `calculate_scaling_operations` to plan shard splits or merges.

## Tools

### calculate_scaling_operations
Determines the necessary shard management actions to reach a target state

### calculate_shard_requirements
Determines the minimum number of shards required to satisfy both ingestion and consumption demands

### calculate_storage_and_efo
Calculates the physical storage footprint and identifies Enhanced Fan-Out consumer capacity

## Prompt Examples

**Prompt:** 
```
How many shards do I need for an ingestion rate of 5000 KB/s and 2000 records per second with 3 consumers using shared throughput?
```

**Response:** 
```
You need 5 shards to handle the ingestion rate and 2 shards for consumption, resulting in a total of 5 shards.
```

**Prompt:** 
```
Calculate the storage needed for 1000 KB/s ingestion with a 24-hour retention period.
```

**Response:** 
```
The total storage required for a 24-hour retention period at 1000 KB/s is approximately 86.4 GB.
```

**Prompt:** 
```
I have 10 shards and I want to scale to 25 shards. How many operations are needed?
```

**Response:** 
```
You will need to perform 15 split operations to reach your target of 25 shards.
```

## Frequently Asked Questions

**How do I calculate the number of shards needed for my data?**
You can use the `calculate_shard_requirements` tool. Provide your ingestion rate in KB/s, records per second, and your consumer profile to get the total shard count.

**Can I estimate my AWS storage costs with this tool?**
While it doesn't provide direct dollar amounts, the `calculate_storage_and_efo` tool provides the total storage in GB, which you can use to estimate your AWS costs.

**How do I scale my Kinesis stream up or down?**
Use the `calculate_scaling_operations` tool. Input your current shard count and your target shard count to see how many splits or merges are required.