Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.dan24ou-cpu/agent-signal

NPM · AGENT-SIGNAL · 2 COMPONENTS · SCANNED AUG 3

Collective intelligence for AI shopping agents — product intel, deals, and more

+44 this week 68 Trust /100
Trust breakdown (6 categories)

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 (138 of 140), 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 (138 of 140), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability69
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 1445 tokens (~111/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage96
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 89% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

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 · agent-signal

# add to Claude Code
claude mcp add dan24ou-cpu-agent-signal -- npx -y agent-signal
# add to Codex CLI
codex mcp add dan24ou-cpu-agent-signal -- npx -y agent-signal
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dan24ou-cpu-agent-signal": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "agent-signal"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add dan24ou-cpu-agent-signal --command npx --arg -y --arg agent-signal
# ~/.hermes/config.yaml
mcp_servers:
  dan24ou-cpu-agent-signal:
    command: "npx"
    args: ["-y", "agent-signal"]
// mcp.json
{
  "mcpServers": {
    "dan24ou-cpu-agent-signal": {
      "command": "npx",
      "args": [
        "-y",
        "agent-signal"
      ]
    }
  }
}
Changelog

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.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +44
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Schema quality: unverified → good functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Licence: MIT functional
  • 31 Jul 26 −26
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 28 Jul 26 +22
    • Tool coverage: unverified → 100 functional
    • First check of Schema quality: unverified functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: fail functional
    • First check of Tool coverage: 89 functional
  • 27 Jul 26 24

    First indexed and scored.

Diagnostics

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/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 138 packages

138 packages in the resolved dependency tree · 138 deprecated · 39 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 13 exposed · ~1,445 tokens

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.

Tool Tokens
check_merchant_reliability ~81

Check a merchant's reliability based on data from other AI agents' shopping sessions. Returns selection rate, stock reliability, match scores, and purchase outcomes. Use this to decide whether to trust a merchant's listings before recommending their products.

NameTypeReqDescription
merchant_idstringyesMerchant identifier to look up, e.g. 'amazon', 'bestbuy'

No output schema declared.

No examples provided.

detect_deal ~107

Compare a product's current price against historical price data from all agents. Returns a verdict (best_price_ever, great_deal, good_deal, fair_price, above_average), savings vs average, and which merchants typically have the best prices. Use this before recommending a purchase to flag deals or overpricing.

NameTypeReqDescription
current_pricenumberyesThe price you're seeing right now
product_idstringyesProduct identifier, e.g. 'sony-wh1000xm5'

No output schema declared.

No examples provided.

get_category_recommendations ~98

Get intelligence about a product category from other AI agents' shopping sessions. Returns which products agents are selecting most, what decision factors matter, common requirements, and average budgets. Use this when starting a shopping task to understand what's working well in a category.

NameTypeReqDescription
budget_maxnumberOptional budget ceiling to filter recommendations
categorystringyesProduct category, e.g. 'footwear/running', 'electronics/headphones'

No output schema declared.

No examples provided.

get_constraint_match ~128

Decision shortcut: find what products worked for agents with your EXACT constraints. Matches on specific requirements (e.g. 'wide fit + cushioned + under $150') and returns what those agents selected, why, and where to buy. Also returns broader recommendations from sessions with overlapping constraints. Use this to skip the search when a proven answer already exists.

NameTypeReqDescription
budget_maxnumberMaximum budget
categorystringyesProduct category, e.g. 'footwear/running'
constraintsarrayyesRequired attributes, e.g. ['wide fit', 'cushioned']

No output schema declared.

No examples provided.

get_product_intelligence ~87

Get crowdsourced intelligence about a product from other AI agents' shopping sessions. Returns selection rate, common rejection reasons, which competitors beat it and why, price ranges seen, and outcome data. Use this before recommending a product to understand how other agents have evaluated it.

NameTypeReqDescription
product_idstringyesProduct identifier to look up, e.g. 'sony-wh1000xm5'

No output schema declared.

No examples provided.

get_session_summary ~50

Retrieve a full summary of a shopping session including all product evaluations, comparisons, and the final outcome. Useful for reviewing what happened during a session.

NameTypeReqDescription
session_idstringyesSession ID to retrieve

No output schema declared.

No examples provided.

get_similar_session_outcomes ~126

Cross-agent learning: see what other AI agents chose when shopping for similar items with similar constraints. Returns which products were selected most often, what deciding factors mattered, and how sessions ended (purchased vs abandoned). Use this at the START of a shopping task to leverage collective agent intelligence.

NameTypeReqDescription
budget_maxnumberMaximum budget to filter similar sessions
categorystringyesProduct category, e.g. 'footwear/running'
constraintsarrayyesShopping constraints, e.g. ['lightweight', 'cushioned', 'wide fit']

No output schema declared.

No examples provided.

get_warnings ~94

Check for recent problems with a product or merchant before recommending them. Surfaces stock issues, high rejection rates, and abandonment signals from other agents. Returns warnings with severity levels (critical, warning, info) or all_clear if safe. Use this as a safety check before finalizing a recommendation.

NameTypeReqDescription
merchant_idstringMerchant to check for warnings
product_idstringProduct to check for warnings

No output schema declared.

No examples provided.

import_completed_session ~124

Bulk-import an entire shopping session after the fact. Use this if you already completed a shopping task WITHOUT agent-signal tools and want to contribute your decision data retroactively. Accepts the full session in one call: intent, product evaluations, comparisons, and outcome. This helps the collective intelligence even when agent-signal wasn't used during the original task.

NameTypeReqDescription
comparisonsarrayComparisons made between products
evaluationsarrayProducts that were evaluated
outcomeobjectFinal outcome of the session
sessionobjectyesShopping session intent

No output schema declared.

No examples provided.

log_comparison ~121

Log a comparison between two or more products during a shopping session. Call this when the agent explicitly compares products to decide between them. Record which product won and what the deciding factor was.

NameTypeReqDescription
deciding_factorstringyesThe primary factor that decided the winner
dimensions_comparedarrayDimensions compared, e.g. ['price', 'reviews', 'durability']
products_comparedarrayyesProduct IDs being compared
session_idstringyes
winner_product_idstringyesThe product that won the comparison

No output schema declared.

No examples provided.

log_outcome ~85

Log the final outcome of a shopping session. Call this when the shopping task ends — whether the user purchased, received a recommendation, abandoned, or deferred the decision.

NameTypeReqDescription
outcome_typestringyes
product_chosen_idstringProduct ID if purchased or recommended
reasonstringWhy this outcome occurred
session_idstringyes

No output schema declared.

No examples provided.

log_product_evaluation ~172

Log that a product was evaluated during a shopping session. Call this for each product the agent considers, whether it's selected, rejected, or shortlisted. Include the rejection reason if the product was rejected.

NameTypeReqDescription
dispositionstringyesWhether the product was selected, rejected, or shortlisted
in_stockboolean
match_reasonsarrayWhy this product was a match
match_scorenumberHow well the product matches intent (0-1)
merchant_idstringMerchant/retailer identifier
price_at_timenumberPrice at time of evaluation
product_idstringyesProduct identifier
rejection_reasonstringWhy the product was rejected
session_idstringyesSession ID from log_shopping_session

No output schema declared.

No examples provided.

log_shopping_session ~172

Start a new shopping session by logging the user's shopping intent. Call this at the beginning of any shopping task to capture what the user wants. Returns a session_id to use with subsequent log calls.

NameTypeReqDescription
agent_platformstringAgent platform identifier
budget_currencystringBudget currency code
budget_maxnumberMaximum budget amount
categorystringProduct category, e.g. 'footwear/running'
constraintsarrayRequired attributes, e.g. ['wide fit', 'cushioned']
exclusionsarrayExcluded brands or features, e.g. ['Nike']
giftbooleanWhether this is a gift purchase
raw_querystringyesThe user's original shopping request
urgencystring

No output schema declared.

No examples provided.