# ScoutScore

> Trust infrastructure for AI agents. ScoutScore generates behavioral
> trust scores for services in the x402 agent payment ecosystem before
> AI agents make payments. The FICO score for AI agents.

## About

ScoutScore monitors 1,500+ x402 service domains in the agent payment
ecosystem. Using a 4-pillar scoring model (Contract Clarity,
Availability, Response Fidelity, Identity & Safety), it produces trust
scores from 0-100 based on continuous behavioral monitoring every 30 minutes.

Founded by Chris Koziak. Registered as ERC-8004 agent #1308 on Ethereum.

## Key Stats

- 1,500+ x402 service domains monitored
- Average ecosystem fidelity score: 52/100
- Health checks every 30 minutes
- Fidelity probes every 6 hours
- Protocol: x402 (exclusive focus)

## Developer Resources

- SDK: npm install @scoutscore/sdk
- MCP Server: npm install @scoutscore/mcp-server
- API Docs: https://scoutscore.ai/docs
- GitHub: https://github.com/scoutscore/scout
- ElizaOS Plugin: PR #6513 at github.com/elizaos/eliza

## Scoring Model

4 pillars, weighted:
- Contract Clarity (20%): pricing accuracy, schema completeness
- Availability (30%): uptime, latency, response consistency
- Response Fidelity (30%): does the service deliver what it promises
- Identity & Safety (20%): wallet patterns, spam detection, identity verification

Trust score = pure weighted average of all 4 pillars. No post-aggregation bonuses/penalties - all modifiers (spam, fidelity, price mismatch) are absorbed into their respective pillars.

Score levels: HIGH (75-100), MEDIUM (50-74), LOW (25-49), VERY_LOW (0-24)

## API Documentation

### Base URL

https://scoutscore.ai

### Authentication

No authentication required during launch period. All endpoints are free and unlimited.

### Endpoints

#### GET /api/bazaar/score/:domain

Get trust score for an x402 service by domain.

Request:
  curl https://scoutscore.ai/api/bazaar/score/recoupable.com

Response:
  {
    "domain": "recoupable.com",
    "score": 100,
    "level": "HIGH",
    "flags": ["HAS_COMPLETE_SCHEMA", "FIDELITY_PROVEN"],
    "recommendation": {
      "verdict": "RECOMMENDED",
      "maxTransaction": -1,
      "escrowTerms": "NONE_REQUIRED"
    }
  }

#### POST /api/bazaar/batch

Score multiple x402 services at once (max 20).

Request:
  curl -X POST https://scoutscore.ai/api/bazaar/batch \
    -H "Content-Type: application/json" \
    -d '{"domains": ["recoupable.com", "lowpaymentfee.com"]}'

Response:
  {
    "results": [
      {
        "domain": "recoupable.com",
        "score": 100,
        "level": "HIGH",
        "flags": ["HAS_COMPLETE_SCHEMA", "FIDELITY_PROVEN"]
      },
      {
        "domain": "lowpaymentfee.com",
        "score": 0,
        "level": "VERY_LOW",
        "flags": ["WALLET_SPAM_FARM", "TEMPLATE_SPAM"]
      }
    ]
  }

#### GET /api/bazaar/stats

Get overall x402 service statistics.

Request:
  curl https://scoutscore.ai/api/bazaar/stats

Response:
  {
    "totalServices": 19456,
    "legitimateServices": 1738,
    "spamPercentage": 87,
    "uniqueWallets": 791,
    "avgScore": 12.4,
    "lastUpdated": "2026-02-19T18:00:00Z"
  }

### TypeScript SDK

Install:
  npm install @scoutscore/sdk

Usage:
  import { ScoutScore } from '@scoutscore/sdk';

  const scout = new ScoutScore();
  const result = await scout.scoreBazaarService('recoupable.com');
  console.log(result.score);  // 100
  console.log(result.level);  // "HIGH"

SDK Methods:
  - scoreBazaarService(domain) - Score a single service
  - scoreBazaarBatch(domains) - Score up to 20 at once
  - getFidelity(domain) - Fidelity check results
  - getLeaderboard(options?) - Browse the leaderboard
  - getBazaarStats() - Platform statistics
  - getHealth() - API health check

### MCP Server

Install:
  npm install @scoutscore/mcp-server

Usage with Claude Code:
  claude mcp add scoutscore npx @scoutscore/mcp-server

Available Tools:
  - check_trust - Get trust score for a domain
  - check_fidelity - Run a fidelity probe
  - get_leaderboard - Browse the service directory
  - get_ecosystem_stats - Platform statistics

### Response Codes

- 200: Success
- 400: Bad request (invalid parameters)
- 404: Domain not found
- 429: Rate limit exceeded
- 500: Server error

### Trust Levels

- HIGH (75-100): Safe to transact
- MEDIUM (50-74): Proceed with caution, use escrow
- LOW (25-49): High risk, small transactions only
- VERY_LOW (0-24): Do not transact

### Common Flags

Risk Flags:
- WALLET_SPAM_FARM - Single wallet running 1000+ services
- TEMPLATE_SPAM - Identical descriptions via content fingerprinting
- MASS_LISTING_SPAM - Domain with 50+ services without unique wallets
- NO_SCHEMA - Missing input/output definitions
- POOR_METADATA - Description under 50 characters
- SCHEMA_PHANTOM - Advertises schema it doesn't serve
- PRICE_MISMATCH - Metadata price differs from actual payment

Trust Flags:
- HAS_COMPLETE_SCHEMA - Full input/output API definition
- GOOD_DOCUMENTATION - Detailed description over 50 characters
- UNIQUE_WALLET_PER_SERVICE - Platform pattern
- ENDPOINT_HEALTHY - Service is online and responsive
- GOOD_UPTIME - 95%+ uptime over 7 days
- FIDELITY_PROVEN - Delivers what it promises