PkgFoundry
Catalog PyPI
PACKAGE EXPLORERView in registry

agent-context-optimizer-mcp

PyPI

MCP Server that solves context window overload — smart tool pruning, relevance scoring, and budget tracking for AI agents

agentcontextmcpoptimizationtoken-budgettool-pruning
Versions collected1
Direct dependencies3From release 0.1.0
Last observed20 Oct, 21:42 UTC

README

Version 0.1.0 documentation

Agent Context Optimizer MCP ⚡

Solves the #1 problem with MCP servers: context window overload.

When you have 10+ MCP servers installed, their tool schemas can consume 40-50% of your context window — leaving less room for actual conversation. This server fixes that.

What it does

  • Analyzes your task and recommends only the servers you actually need
  • Estimates token usage for any combination of servers
  • Optimizes your server set by identifying which servers to unload
  • Suggests minimal configurations for maximum context efficiency

Installation

pip install agent-context-optimizer-mcp

Usage with Claude Code

{
  "mcpServers": {
    "optimizer": {
      "command": "uvx",
      "args": ["agent-context-optimizer-mcp"]
    }
  }
}

Tools

ToolDescription
analyze_taskAnalyze a task and recommend optimal server combination
estimate_context_usageEstimate context window consumption for servers
get_server_catalogFull catalog of known MCP servers with categories
optimize_server_setOptimize currently loaded servers for a task
suggest_minimal_setRecommend the absolute minimum servers needed

Example

"I need to check the safety of a Solana token"
→ Recommends: solana (required)
→ Saves: 85% context tokens vs loading all servers

Why this matters

  • Average MCP server uses ~3,000 tokens for tool schemas
  • 10 servers = ~30,000 tokens = 15% of a 200k context window
  • 20 servers = ~60,000 tokens = 30% wasted on tool definitions
  • This optimizer helps you load only what you need

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.020 Mar 20263
Sorted by available source dates · UTC

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
aiagentkarl/agent-context-optimizer-mcp

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:42 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:18ea30ec12af2151840e55e0b3f8ca626a392e4c8f039c4568781cbc28de76fc