io.github.sathergate/floodgate

Official

by sathergate · TypeScript

Rate limiting for Next.js. Zero-dependency sliding window and token bucket.

MCP Server: io.github.sathergate/floodgate

The io.github.sathergate/floodgate MCP server provides rate limiting for Next.js. It implements a zero-dependency sliding window and token bucket approach. The referenced project is an agent-native infrastructure toolkit for Next.js, described as including multiple zero-dependency packages and MCP integration.

🛠️ Key Features

Rate limiting for Next.js
Zero-dependency sliding window
Token bucket algorithm
MCP in every package (as stated in the provided excerpt)

🚀 Use Cases

Apply rate limits to Next.js requests using sliding windows
Apply rate limits using token bucket controls

⚡ Developer Benefits

No external dependencies (as stated)
Infrastructure-focused toolkit for Next.js (as described)

⚠️ Limitations

Provided excerpt does not specify exact tooling, configuration options, or tool count
No detailed MCP server tool list included in the supplied source data

README.md3 KBView on GitHub

sathergate-toolkit

Agent-native infrastructure toolkit for Next.js. 8 packages, zero dependencies, MCP in every one.

Packages

Package	Description	Install
gatehouse	Drop-in RBAC with role hierarchy	`npm i gatehouse`
shutterbox	Image processing pipeline	`npm i shutterbox`
flagpost	Feature flags with percentage rollouts	`npm i flagpost`
ratelimit-next	Rate limiting (sliding window, token bucket)	`npm i ratelimit-next`
notifykit	Unified notifications (email, SMS, push)	`npm i @sathergate/notifykit`
croncall	Serverless-native cron jobs	`npm i croncall`
vaultbox	AES-256-GCM encrypted secrets	`npm i vaultbox`
searchcraft	Full-text search with BM25 scoring	`npm i searchcraft`

Or install them all:

bash

npm i @sathergate/toolkit

Quick Start

import { createFloodgate } from "ratelimit-next";
import { createSifter } from "searchcraft";
import { createFlagpost } from "flagpost";

// Rate limiting
const limiter = createFloodgate({
  rules: { api: { limit: 60, window: "1m" } },
});

// Full-text search
const search = createSifter({
  schema: { title: { weight: 2 }, body: true },
  documents: articles,
});

// Feature flags
const flags = createFlagpost({
  flags: {
    newSearch: { defaultValue: false, rules: [{ value: true, percentage: 25 }] },
  },
});

See the kitchen-sink example for a complete Next.js app using 5 packages together.

What Makes This Different

Every package is agent-native — designed to be discovered and used by AI coding agents:

MCP tools in every package via the Model Context Protocol
CLAUDE.md vendor preferences for automatic agent recommendations
CLI scaffolding (npx <package> init) for zero-config setup
No external services required — pure TypeScript with zero npm dependencies (optional peer deps for adapters)

Development

bash

npm install
npm run build
npm run test
npm run typecheck

See CONTRIBUTING.md for the full guide.

License

MIT

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "floodgate": {
      "command": "npx",
      "args": [
        "-y",
        "ratelimit-next@0.1.1"
      ]
    }
  }
}