How do I install Flatten?

Flatten is a local plugin. Install it using npm package: flatten-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Flatten safe to use?

Flatten scored 5.2/10 (moderate risk) in MCP Marketplace's automated security scan. It has 3 high or critical findings to review. It's listed, but review the security report on this page before installing.

What credentials does Flatten need?

Flatten requires the following credentials or environment variables: ANTHROPIC_API_KEY, FLATTEN_COUNT_MODEL. You can find setup instructions on the server detail page.

What AI apps work with Flatten?

Flatten uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Flatten MCP Server

by ShayaShav

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

Flatten Claude Code sessions: keep every prompt and event verbatim, resume at a lower token count.

About

Flatten Claude Code sessions: keep every prompt and event verbatim, resume at a lower token count.

Security Report

5.2

Moderate5.2Moderate Risk

flatten-mcp is a well-architected MCP server with clean security practices. The codebase demonstrates strong file handling with atomic writes, crash-safe sidecar persistence, and explicit session backups. Permissions are appropriately scoped to Claude Code's session directory. No credentials are hardcoded, and network access is limited to an optional Anthropic API call for token counting when explicitly configured via environment variable. Minor code quality improvements around error handling could be made, but the server poses no significant security risk. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

4 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_cwd

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional. If set, token savings are counted exactly via Anthropic's count_tokens endpoint instead of estimated locally.Required

Environment variable: ANTHROPIC_API_KEY

Optional. Model id used for the exact token count (default: claude-haiku-4-5-20251001).Optional

Environment variable: FLATTEN_COUNT_MODEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-shayashav-flatten-mcp": {
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-api-key-here",
        "FLATTEN_COUNT_MODEL": "your-flatten-count-model-here"
      },
      "args": [
        "-y",
        "flatten-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Flatten MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

What You'll Need

How to Install

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MarkItDown

FinAgent