{
  "project_id": "headroomlabs-ai/headroom",
  "repo": "headroomlabs-ai/headroom",
  "name": "headroom",
  "github_url": "https://github.com/headroomlabs-ai/headroom",
  "homepage_url": "https://docs.headroomlabs.ai/docs",
  "language": "Python",
  "license": "Apache-2.0",
  "project_kind": "project",
  "category": [
    "mcp_server"
  ],
  "tags": [
    "agent",
    "ai",
    "anthropic",
    "claude-code",
    "compression",
    "context-engineering",
    "context-window",
    "cursor",
    "fastapi",
    "langchain",
    "llm",
    "mcp",
    "openai",
    "prompt-engineering",
    "proxy",
    "python",
    "rag",
    "token-optimization",
    "tokens",
    "typescript"
  ],
  "description": "Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.",
  "overview": "Use headroomlabs-ai/headroom when the user needs a mcp server project with docker, vercel, serverless deployment options.",
  "alternatives": [
    {
      "repo": "BerriAI/litellm",
      "reason": "Same mcp server intent with mcp, llm_gateway overlap."
    },
    {
      "repo": "can1357/oh-my-pi",
      "reason": "Same mcp server intent with coding_agent, mcp overlap."
    },
    {
      "repo": "rocketride-org/rocketride-server",
      "reason": "Same mcp server intent with mcp, llm_gateway overlap."
    }
  ],
  "related": [
    {
      "repo": "yonatangross/orchestkit",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    },
    {
      "repo": "Deuz-AI/Deuz-SDK",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and vercel deployment."
    },
    {
      "repo": "open-multi-agent/open-multi-agent",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    },
    {
      "repo": "ohad6k/emulo",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    },
    {
      "repo": "deepset-ai/haystack",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    },
    {
      "repo": "iflytek/astron-agent",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    },
    {
      "repo": "datawhalechina/easy-vibe",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    },
    {
      "repo": "MODSetter/SurfSense",
      "reason": "Related to headroomlabs-ai/headroom through mcp server category and docker deployment."
    }
  ],
  "dependencies": [
    "MCP",
    "Vector database",
    "LLM provider"
  ],
  "deployments": [
    "docker",
    "vercel",
    "serverless",
    "library_only",
    "local"
  ],
  "difficulty": "advanced",
  "cloudflare_ready": false,
  "use_cases": [
    "connect agents to tools",
    "expose APIs through MCP",
    "bootstrap MCP integrations"
  ],
  "not_good_for": [
    "edge-only Cloudflare Workers deployment without adaptation",
    "users expecting a complete hosted product"
  ],
  "classification": {
    "category": {
      "confidence": "high",
      "evidence": [
        "Matched \"mcp server\" in metadata.",
        "Matched \"mcp\" in metadata."
      ]
    },
    "deployment": {
      "confidence": "high",
      "evidence": [
        "Found Docker configuration file.",
        "Matched \"vercel\" in repository content.",
        "Matched \"pip install\" in repository content.",
        "Matched \"npm install\" in repository content.",
        "Matched \"library\" in repository content.",
        "Local usage is assumed for open source repositories unless contradicted."
      ]
    },
    "difficulty": {
      "confidence": "medium",
      "evidence": [
        "Found multi-service or orchestration configuration files."
      ]
    },
    "cloudflare_ready": {
      "confidence": "high",
      "evidence": [
        "Runtime blocker: python.",
        "No Cloudflare deployment signal detected.",
        "No wrangler.toml found in inspected repository files."
      ]
    }
  },
  "quality_signals": {
    "stars": 71802,
    "recent_commits": 100,
    "contributors": 100,
    "issue_response_time_hours": null,
    "release_frequency_180d": 100
  },
  "quality_signal_confidence": {
    "stars_30d_delta": "snapshot",
    "stars30d_window_days": 30,
    "commits_30d": "partial",
    "releases_180d": "partial",
    "contributors_90d": "partial"
  },
  "quality_score": 84,
  "agent_score": 92,
  "score": 94,
  "agent_score_breakdown": {
    "documentation": 90,
    "maintenance": 76,
    "deployment": 100,
    "popularity": 97,
    "community": 100
  },
  "git_top_score": 94,
  "git_top_score_breakdown": {
    "community": 100,
    "maintenance": 84,
    "documentation": 92,
    "stability": 90,
    "adoption": 100,
    "agent_readability": 100
  },
  "verification": {
    "schema_version": "git-top.verification.v1",
    "overall_status": "partial",
    "observed_at": "2026-09-13T10:00:52.414Z",
    "signals": {
      "activity": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.pushed_at",
          "metrics.recent_push_days"
        ]
      },
      "license": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.license"
        ]
      },
      "documentation": {
        "status": "observed",
        "source": "github_metadata",
        "evidence": [
          "project.description"
        ]
      },
      "runtime": {
        "status": "inferred",
        "source": "git_top_heuristic",
        "evidence": [
          "agent_card.deployment",
          "agent_card.cloudflare_ready"
        ]
      },
      "install": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "installation/build probe is not enabled"
        ]
      },
      "security": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "dependency/security scan is not enabled"
        ]
      },
      "mcp": {
        "status": "not_run",
        "source": "git_top_runtime",
        "evidence": [
          "MCP liveness and tool-call probe is not enabled"
        ]
      }
    },
    "coverage": {
      "observed": 3,
      "inferred": 1,
      "not_run": 3,
      "unknown": 0
    },
    "next_steps": [
      "Run an installation/build probe before production adoption.",
      "Run a dependency and security scan before treating the score as a trust claim.",
      "Run MCP initialize, tools/list, first-call, and error probes before relying on this server."
    ]
  },
  "summary": {
    "tl_dr": "Use headroomlabs-ai/headroom when the user needs a mcp server project with docker, vercel, serverless deployment options.",
    "purpose": "Use headroomlabs-ai/headroom when the user needs a mcp server project with docker, vercel, serverless deployment options.",
    "install": "Run with Docker using the repository's container instructions.",
    "inputs": [
      "tool definitions",
      "resource config",
      "transport settings"
    ],
    "outputs": [
      "MCP tools",
      "JSON-RPC responses",
      "server capabilities"
    ],
    "good_for": [
      "connect agents to tools",
      "expose APIs through MCP",
      "bootstrap MCP integrations",
      "agent tool exposure",
      "MCP integrations",
      "tool servers"
    ],
    "not_good_for": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product",
      "front-end apps",
      "non-tooling backends"
    ],
    "deployment": [
      "docker",
      "vercel",
      "serverless",
      "library_only",
      "local"
    ],
    "alternatives": [
      {
        "repo": "BerriAI/litellm",
        "reason": "Same mcp server intent with mcp, llm_gateway overlap."
      },
      {
        "repo": "can1357/oh-my-pi",
        "reason": "Same mcp server intent with coding_agent, mcp overlap."
      },
      {
        "repo": "rocketride-org/rocketride-server",
        "reason": "Same mcp server intent with mcp, llm_gateway overlap."
      }
    ]
  },
  "evidence": {
    "classification": {
      "category": {
        "confidence": "high",
        "evidence": [
          "Matched \"mcp server\" in metadata.",
          "Matched \"mcp\" in metadata."
        ]
      },
      "deployment": {
        "confidence": "high",
        "evidence": [
          "Found Docker configuration file.",
          "Matched \"vercel\" in repository content.",
          "Matched \"pip install\" in repository content.",
          "Matched \"npm install\" in repository content.",
          "Matched \"library\" in repository content.",
          "Local usage is assumed for open source repositories unless contradicted."
        ]
      },
      "difficulty": {
        "confidence": "medium",
        "evidence": [
          "Found multi-service or orchestration configuration files."
        ]
      },
      "cloudflare_ready": {
        "confidence": "high",
        "evidence": [
          "Runtime blocker: python.",
          "No Cloudflare deployment signal detected.",
          "No wrangler.toml found in inspected repository files."
        ]
      }
    },
    "quality_signal_confidence": {
      "stars_30d_delta": "snapshot",
      "stars30d_window_days": 30,
      "commits_30d": "partial",
      "releases_180d": "partial",
      "contributors_90d": "partial"
    },
    "verification": {
      "schema_version": "git-top.verification.v1",
      "overall_status": "partial",
      "observed_at": "2026-09-13T10:00:52.414Z",
      "signals": {
        "activity": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.pushed_at",
            "metrics.recent_push_days"
          ]
        },
        "license": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.license"
          ]
        },
        "documentation": {
          "status": "observed",
          "source": "github_metadata",
          "evidence": [
            "project.description"
          ]
        },
        "runtime": {
          "status": "inferred",
          "source": "git_top_heuristic",
          "evidence": [
            "agent_card.deployment",
            "agent_card.cloudflare_ready"
          ]
        },
        "install": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "installation/build probe is not enabled"
          ]
        },
        "security": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "dependency/security scan is not enabled"
          ]
        },
        "mcp": {
          "status": "not_run",
          "source": "git_top_runtime",
          "evidence": [
            "MCP liveness and tool-call probe is not enabled"
          ]
        }
      },
      "coverage": {
        "observed": 3,
        "inferred": 1,
        "not_run": 3,
        "unknown": 0
      },
      "next_steps": [
        "Run an installation/build probe before production adoption.",
        "Run a dependency and security scan before treating the score as a trust claim.",
        "Run MCP initialize, tools/list, first-call, and error probes before relying on this server."
      ]
    },
    "source_fields": [
      "project.description",
      "project.topics",
      "project.language",
      "project.license",
      "agent_card.summary_for_agent",
      "agent_card.use_cases",
      "agent_card.deployment",
      "agent_card.classification",
      "metrics",
      "verification.signals"
    ],
    "caveats": [
      "edge-only Cloudflare Workers deployment without adaptation",
      "users expecting a complete hosted product",
      "Partial or estimated quality signals: commits30d, releases180d, contributors90d.",
      "Independent installation, security, or runtime probes have not been run for this project."
    ],
    "confidence_reason": "Evidence is usable for comparison, but agents should cite caveats before making a strong recommendation.",
    "last_verified_at": "2026-09-13T10:00:52.414Z"
  },
  "caveats": [
    "edge-only Cloudflare Workers deployment without adaptation",
    "users expecting a complete hosted product",
    "Partial or estimated quality signals: commits30d, releases180d, contributors90d.",
    "Independent installation, security, or runtime probes have not been run for this project."
  ],
  "confidence_reason": "Evidence is usable for comparison, but agents should cite caveats before making a strong recommendation.",
  "source_fields": [
    "project.description",
    "project.topics",
    "project.language",
    "project.license",
    "agent_card.summary_for_agent",
    "agent_card.use_cases",
    "agent_card.deployment",
    "agent_card.classification",
    "metrics",
    "verification.signals"
  ],
  "last_verified_at": "2026-09-13T10:00:52.414Z",
  "knowledge": {
    "project": {
      "id": "headroomlabs-ai/headroom",
      "owner": "headroomlabs-ai",
      "name": "headroom",
      "full_name": "headroomlabs-ai/headroom",
      "github_url": "https://github.com/headroomlabs-ai/headroom",
      "homepage_url": "https://docs.headroomlabs.ai/docs",
      "description": "Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.",
      "language": "Python",
      "topics": [
        "agent",
        "ai",
        "anthropic",
        "claude-code",
        "compression",
        "context-engineering",
        "context-window",
        "cursor",
        "fastapi",
        "langchain",
        "llm",
        "mcp",
        "openai",
        "prompt-engineering",
        "proxy",
        "python",
        "rag",
        "token-optimization",
        "tokens",
        "typescript"
      ],
      "license": "Apache-2.0",
      "stars": 71802,
      "forks": 5500,
      "open_issues": 638,
      "default_branch": "main",
      "created_at": "2026-01-07T19:58:51Z",
      "updated_at": "2026-09-13T09:51:52Z",
      "pushed_at": "2026-09-13T02:48:10Z",
      "synced_at": "2026-09-13T10:00:52.414Z"
    },
    "agent_card": {
      "project_id": "headroomlabs-ai/headroom",
      "project_kind": "project",
      "category": "mcp_server",
      "difficulty": "advanced",
      "deployment": [
        "docker",
        "vercel",
        "serverless",
        "library_only",
        "local"
      ],
      "cloudflare_ready": false,
      "use_cases": [
        "connect agents to tools",
        "expose APIs through MCP",
        "bootstrap MCP integrations"
      ],
      "not_good_for": [
        "edge-only Cloudflare Workers deployment without adaptation",
        "users expecting a complete hosted product"
      ],
      "alternatives": [
        {
          "project_id": "BerriAI/litellm",
          "reason": "Same mcp server intent with mcp, llm_gateway overlap."
        },
        {
          "project_id": "can1357/oh-my-pi",
          "reason": "Same mcp server intent with coding_agent, mcp overlap."
        },
        {
          "project_id": "rocketride-org/rocketride-server",
          "reason": "Same mcp server intent with mcp, llm_gateway overlap."
        }
      ],
      "summary_for_agent": "Use headroomlabs-ai/headroom when the user needs a mcp server project with docker, vercel, serverless deployment options.",
      "classification": {
        "category": {
          "confidence": "high",
          "evidence": [
            "Matched \"mcp server\" in metadata.",
            "Matched \"mcp\" in metadata."
          ]
        },
        "deployment": {
          "confidence": "high",
          "evidence": [
            "Found Docker configuration file.",
            "Matched \"vercel\" in repository content.",
            "Matched \"pip install\" in repository content.",
            "Matched \"npm install\" in repository content.",
            "Matched \"library\" in repository content.",
            "Local usage is assumed for open source repositories unless contradicted."
          ]
        },
        "difficulty": {
          "confidence": "medium",
          "evidence": [
            "Found multi-service or orchestration configuration files."
          ]
        },
        "cloudflare_ready": {
          "confidence": "high",
          "evidence": [
            "Runtime blocker: python.",
            "No Cloudflare deployment signal detected.",
            "No wrangler.toml found in inspected repository files."
          ]
        }
      },
      "schema_version": "v1",
      "generated_at": "2026-09-13T10:00:52.414Z"
    },
    "metrics": {
      "project_id": "headroomlabs-ai/headroom",
      "stars_30d_delta": 5611,
      "commits_30d": 100,
      "releases_180d": 100,
      "contributors_90d": 100,
      "issue_first_response_median_hours": null,
      "recent_push_days": 0,
      "git_score": 84,
      "maintenance_score": 76,
      "signal_confidence": {
        "stars_30d_delta": "snapshot",
        "stars30d_window_days": 30,
        "commits_30d": "partial",
        "releases_180d": "partial",
        "contributors_90d": "partial"
      },
      "calculated_at": "2026-09-13T10:00:52.414Z"
    }
  },
  "resolved_from": {
    "requested_id": "headroomlabs-ai/headroom",
    "resolved_id": "headroomlabs-ai/headroom",
    "resolution": "direct"
  },
  "metadata": {
    "source": "d1",
    "reason": "d1_query",
    "project_count": 1214,
    "generated_at": "2026-09-14T17:43:39.637Z",
    "snapshot_id": "d1:1214:2026-09-14T17:31:24.986Z",
    "latest_synced_at": "2026-09-14T17:31:24.986Z",
    "schema_version": "git-top.knowledge.v1",
    "loaded_project_limit": 2000,
    "truncated": false
  }
}