io.github.shivam-app-developers/ai-optimizer
NPM · @AI-OPTIMIZER/CORE · SCANNED AUG 3
MCP server that cuts AI coding agent token usage via framework-aware context optimization
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to shivam-app-developers/ai-optimizer). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 57 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability71
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 954 tokens (~86/item across 11 items; 11 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @ai-optimizer/core
claude mcp add shivam-app-developers-ai-optimizer -- npx -y @ai-optimizer/core
codex mcp add shivam-app-developers-ai-optimizer -- npx -y @ai-optimizer/core
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"shivam-app-developers-ai-optimizer": {
"type": "local",
"command": [
"npx",
"-y",
"@ai-optimizer/core"
],
"enabled": true
}
}
} openclaw mcp add shivam-app-developers-ai-optimizer --command npx --arg -y --arg @ai-optimizer/core
mcp_servers:
shivam-app-developers-ai-optimizer:
command: "npx"
args: ["-y", "@ai-optimizer/core"] {
"mcpServers": {
"shivam-app-developers-ai-optimizer": {
"command": "npx",
"args": [
"-y",
"@ai-optimizer/core"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +42
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- The attested source repository moved: shivam-app-developers/ai-optimizer security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: unverified → good ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Stability: unverified → 0.20 ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Licence: MIT functional
- 1 Aug 26 +10
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Capabilities: pass → unverified ▼ functional
- 31 Jul 26 −20
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 +22
- Tool coverage: unverified → 100 ▲ functional
- 28 Jul 26 −22
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- 27 Jul 26 46
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/@ai-optimizer/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- shivam-app-developers/ai-optimizer
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/shivam-app-developers/ai-optimizer/.github/workflows/release.yml@refs/tags/v0.1.0
- Rekor log index:
- 1739580074
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:f60b70a03b54ed9661e3b08a41e385361014ef81b2c2d784289de16d96c8c6c49fa77608348f07be6780d418ddceb747fa71219126dca051b23b2ae4e
- Discovery method:
- attestation_endpoint
Dependencies 96 packages
96 packages in the resolved dependency tree · 96 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
budget_reset Reset budget counters ~27
Zeroes the per-session and per-day token counters. Use after intentionally clearing a budget breach.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
budget_status Show conversation/day budget status ~87
Reports the current per-session and per-day token consumption against configured caps. Caps are set via budgetCaps in .optimizerrc.json or AI_OPTIMIZER_BUDGET_PER_SESSION / AI_OPTIMIZER_BUDGET_PER_DAY env vars. When a cap is exceeded, optimized_read_file / list_files / grep / diagnostics refuse new calls until reset or until UTC midnight (day cap).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_optimizer_config Get optimizer config ~53
Returns the merged effective configuration: defaults overridden by user-global config, then project .optimizerrc.json, then env vars. Use to check whether scheduling, work-stealing, telemetry, etc. are currently enabled.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
optimized_diagnostics Get LSP diagnostics for a file (token-optimized) ~103
Returns errors and warnings from the language server for a single file, plus narrow code slices around each diagnostic. Use this BEFORE calling optimized_read_file when the agent is trying to fix an error — it returns ~10 lines of context around each issue instead of the whole file. Detected frameworks: javascript
| Name | Type | Req | Description |
|---|---|---|---|
| contextLines | integer | — | Lines of context around each diagnostic (default 10) |
| path | string | yes | Path to the file, relative to project root |
No output schema declared.
No examples provided.
optimized_grep Grep across files (token-optimized) ~119
Search file contents for a regex, scoped by directory and optional file glob, applying framework-aware ignore filters. Skips files larger than 2MB and caps at 100 matches. Detected frameworks: javascript
| Name | Type | Req | Description |
|---|---|---|---|
| directory | string | — | Directory to search, relative to project root |
| filePattern | string | — | Optional glob pattern to filter files, e.g. "**/*.ts" |
| flags | string | — | Regex flags, e.g. "i" for case-insensitive |
| pattern | string | yes | Regex pattern to search for |
No output schema declared.
No examples provided.
optimized_list_files List files (token-optimized) ~89
List files in a directory with framework-aware ignore filtering. Skips node_modules, .venv, build/, dist/, generated files, etc. Optionally pass a glob pattern to narrow results. Detected frameworks: javascript
| Name | Type | Req | Description |
|---|---|---|---|
| directory | string | — | Directory to list, relative to project root |
| pattern | string | — | Optional glob pattern to filter results, e.g. "**/*.ts" |
No output schema declared.
No examples provided.
optimized_read_file Read file (token-optimized) ~121
Read a file from the workspace with framework-aware filtering. Skips files matching framework ignore patterns or .gitignore. Use this instead of the built-in Read tool to reduce token usage. Optionally pass startLine/endLine (1-indexed, inclusive) to read only a slice. Detected frameworks: javascript
| Name | Type | Req | Description |
|---|---|---|---|
| endLine | integer | — | 1-indexed end line (inclusive) |
| path | string | yes | Path to the file, relative to the project root |
| startLine | integer | — | 1-indexed start line (inclusive) |
No output schema declared.
No examples provided.
optimizer_status Optimizer status ~29
Returns active framework packs, detected project type, gitignore status, and cumulative token savings for this session.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
read_symbol Read a symbol body via LSP (no whole-file read) ~166
Resolves a symbol name (e.g. "UserRepository.getUser", "users::repository::get") via the language server's workspace/symbol API and returns just the symbol body. Use this when you need a function or class definition but not the rest of the file. Falls back to no-match when the LSP can't resolve the symbol. Detected frameworks: javascript
| Name | Type | Req | Description |
|---|---|---|---|
| contextLines | integer | — | Lines of context to include before + after each symbol body |
| includeImports | boolean | — | Prepend leading imports / package / use lines from the file |
| maxMatches | integer | — | Cap on number of symbol matches returned (default 5) |
| query | string | yes | Symbol name, optionally container-qualified (Foo.bar / Foo::bar / Foo#bar) |
No output schema declared.
No examples provided.
set_optimizer_config Set optimizer config (writes to project .optimizerrc.json) ~93
Writes a partial config patch to the project-level .optimizerrc.json (merging with whatever is already there). User-global config and env vars are NOT modified — those are managed out-of-band. Behavior-changing flags (scheduling, workStealing, telemetry) require explicit opt-in via this tool — they are off by default.
| Name | Type | Req | Description |
|---|---|---|---|
| patch | object | yes | Partial OptimizerConfig to merge into project config |
No output schema declared.
No examples provided.
strip_bash_noise Strip noise from shell command output (token-optimized) ~67
Removes ANSI color codes, npm/maven/gradle progress lines, JVM reflective-access warnings, and collapses carriage-return progress bars. Pass the raw stdout/stderr from a Bash tool call here BEFORE keeping it in context.
| Name | Type | Req | Description |
|---|---|---|---|
| output | string | yes | Raw shell output to clean |
No output schema declared.
No examples provided.