Skip to main content
Glama

AgentSignal

npm version GitHub stars License: MIT MCP Tools

The collective intelligence layer for AI shopping agents.

Every agent that connects makes every other agent smarter. 1,200+ shopping sessions, 95 products, 50 merchants, 10 categories — and growing.

Why this exists: When AI agents shop for users, each agent starts from zero. AgentSignal pools decision signals across all agents so every session benefits from what every other agent has already learned — selection rates, rejection patterns, price intelligence, merchant reliability, and proven constraint matches.

Quick Start (30 seconds)

Remote — zero install, instant intelligence:

{
  "mcpServers": {
    "agent-signal": {
      "url": "https://agent-signal-production.up.railway.app/mcp"
    }
  }
}

Local via npx:

npx agent-signal

Claude Desktop / Claude Code:

{
  "mcpServers": {
    "agent-signal": {
      "command": "npx",
      "args": ["agent-signal"]
    }
  }
}

One Call to Start Shopping Smarter

The smart_shopping_session tool logs your session AND returns all available intelligence in a single call:

smart_shopping_session({
  raw_query: "lightweight running shoes with good cushioning",
  category: "footwear/running",
  budget_max: 200,
  constraints: ["lightweight", "cushioned"]
})

Returns:

  • Your session ID for subsequent logging

  • Top picks from other agents in that category

  • What constraints and factors mattered most

  • How similar sessions ended (purchased vs abandoned)

  • Network-wide stats

23 MCP Tools

Tool

What it does

smart_shopping_session

Start session + get category intelligence + similar session outcomes — all in one call

evaluate_and_compare

Log product evaluation + get product intelligence + deal verdict — all in one call

Buyer Intelligence — Shop Smarter

Tool

What it tells you

get_product_intelligence

Selection rate, rejection reasons, which competitors beat it and why

get_category_recommendations

Top picks, decision factors, common requirements, average budgets

check_merchant_reliability

Stock accuracy, selection rate, purchase outcomes by merchant

get_similar_session_outcomes

What agents with similar constraints ended up choosing

detect_deal

Price verdict against historical data — best_price_ever to above_average

get_warnings

Stock issues, high rejection rates, abandonment signals

get_constraint_match

Products that exactly match your constraints — skip the search

Seller Intelligence — Understand Your Market

Tool

What it tells you

get_competitive_landscape

Category rank, head-to-head win rate, who beats you and why, price positioning

get_rejection_analysis

Why agents reject your product, weekly trends, what they chose instead

get_category_demand

What agents are searching for, unmet needs, budget distribution, market gaps

get_merchant_scorecard

Full merchant report — stock reliability, price competitiveness, selection rates by category

Discovery & Monitoring

Tool

What it tells you

get_budget_products

Best products within a specific budget — ranked by agent selections, with merchant availability

get_trending_products

Products trending up or down — compares current vs previous period selection rates

create_price_alert

Set a price alert — triggers when agents spot the product at or below your target

check_price_alerts

Check which alerts have been triggered by recent agent activity

Write Tools — Contribute Back

Tool

What it captures

log_shopping_session

Shopping intent, constraints, budget, exclusions

log_product_evaluation

Product considered, match score, disposition + rejection reason

log_comparison

Products compared, dimensions, winner, deciding factor

log_outcome

Final result — purchased, recommended, abandoned, or deferred

import_completed_session

Bulk import a completed session retroactively

get_session_summary

Retrieve full session details

Example: Full Agent Workflow

# 1. Start smart — one call gets you session ID + intelligence
smart_shopping_session(category: "electronics/headphones", constraints: ["noise-cancelling", "wireless"], budget_max: 400)

# 2. Evaluate products — get intel as you log
evaluate_and_compare(session_id: "...", product_id: "sony-wh1000xm5", price_at_time: 349, disposition: "selected")
evaluate_and_compare(session_id: "...", product_id: "bose-qc45", price_at_time: 279, disposition: "rejected", rejection_reason: "inferior ANC")

# 3. Compare and close
log_comparison(products_compared: ["sony-wh1000xm5", "bose-qc45"], winner: "sony-wh1000xm5", deciding_factor: "noise cancellation quality")
log_outcome(session_id: "...", outcome_type: "purchased", product_chosen_id: "sony-wh1000xm5")

Every step feeds the network. The next agent shopping for headphones benefits from your data.

Example: Seller Intelligence Workflow

# 1. How is my product performing vs competitors?
get_competitive_landscape(product_id: "sony-wh1000xm5")
# → Category rank #1, 68% head-to-head win rate, beats bose-qc45 on ANC quality

# 2. Why are agents rejecting my product?
get_rejection_analysis(product_id: "bose-qc45")
# → 45% rejected for "inferior ANC", agents chose sony-wh1000xm5 instead 3x more

# 3. What do agents want in my category?
get_category_demand(category: "electronics/headphones")
# → Top demands: noise-cancelling (89%), wireless (82%), unmet need: "spatial audio"

# 4. How does my store perform?
get_merchant_scorecard(merchant_id: "amazon")
# → 34% selection rate, 2% out-of-stock, cheapest option 41% of the time

Categories with Active Intelligence

Category

Sessions

footwear/running

150+

electronics/headphones

140+

gaming/accessories

130+

electronics/tablets

130+

home/furniture/desks

120+

fitness/wearables

118+

electronics/phones

115+

home/smart-home

107+

kitchen/appliances

105+

electronics/laptops

98+

Agent Framework Examples

Ready-to-run examples in /examples:

Framework

File

Description

LangChain

langchain-shopping-agent.py

ReAct agent with LangGraph + MCP adapter

CrewAI

crewai-shopping-crew.py

Two-agent crew (researcher + shopper)

AutoGen

autogen-shopping-agent.py

AutoGen agent with MCP tools

OpenAI Agents

openai-agents-shopping.py

OpenAI Agents SDK with Streamable HTTP

Claude

claude-system-prompt.md

Optimized system prompt for Claude Desktop/Code

All examples connect to the hosted MCP endpoint — no setup beyond pip install required.

REST API

Merchant-facing analytics at https://agent-signal-production.up.railway.app/api:

Endpoint

Description

GET /api/products/:id/insights

Product analytics — consideration rate, rejection reasons

GET /api/categories/:category/trends

Category trends — top factors, budgets, attributes

GET /api/competitive/lost-to?product_id=X

Competitive losses — what X loses to and why

GET /api/sessions

Recent sessions (paginated)

GET /api/sessions/:id

Full session detail

POST /api/admin/aggregate

Trigger insight computation

GET /api/health

Health check

Self-Hosting

git clone https://github.com/dan24ou-cpu/agent-signal.git
cd agent-signal
npm install
cp .env.example .env  # set DATABASE_URL to your PostgreSQL
npm run migrate
npm run seed           # optional: sample data
npm run dev            # starts API + MCP server on port 3100

Architecture

  • MCP Server — Stdio transport (local) + Streamable HTTP (remote)

  • REST API — Express on the same port

  • Database — PostgreSQL (Neon-compatible)

  • 23 MCP tools — 17 read (buyer + seller + discovery) + 6 write

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dan24ou-cpu/agent-signal'

If you have feedback or need assistance with the MCP directory API, please join our Discord server