GitDealFlow — GitHub signals for startup investors

Top 20 startups by engineering acceleration across all 15 sectors for the current weekly period. Read-only, idempotent.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "description": "Reporting period label, e.g. 'Q2 2026'."
    },
    "startups": {
      "type": "array",
      "description": "Top 20 startups ranked by engineering acceleration.",
      "items": {
        "type": "object",
        "description": "A single startup ranked by engineering acceleration, derived from public GitHub activity.",
        "properties": {
          "rank": {
            "type": "integer",
            "description": "1-indexed rank within this result set."
          },
          "name": {
            "type": "string",
            "description": "Startup or GitHub org name."
          },
          "sector": {
            "type": "string",
            "description": "Sector the startup is classified into."
          },
          "stage": {
            "type": "string",
            "description": "Funding stage if known (e.g. 'Seed', 'Series A', 'Unknown')."
          },
          "geography": {
            "type": "string",
            "description": "Headquarters region if known."
          },
          "commitVelocity14d": {
            "type": "number",
            "description": "Commits across tracked repos in the trailing 14 days."
          },
          "commitVelocityChange": {
            "type": "string",
            "description": "Percentage change in commit velocity vs. the prior 14-day window, e.g. '+142%'."
          },
          "contributors": {
            "type": "integer",
            "description": "Distinct contributors active in the last 30 days."
          },
          "contributorGrowth": {
            "type": "string",
            "description": "Percentage change in contributor count vs. the prior 30-day window."
          },
          "newRepos": {
            "type": "integer",
            "description": "New public repositories created in the last 30 days."
          },
          "signalType": {
            "type": "string",
            "description": "Classification label. Common values: 'breakout' (sudden surge), 'acceleration' (sustained growth), 'steady' (healthy baseline), 'cooling' (declining)."
          },
          "description": {
            "type": "string",
            "description": "One-line summary of the startup."
          },
          "githubUrl": {
            "type": "string",
            "format": "uri",
            "description": "Primary GitHub org URL."
          },
          "websiteUrl": {
            "type": "string",
            "format": "uri",
            "description": "Company website if known."
          },
          "linkedinUrl": {
            "type": "string",
            "format": "uri",
            "description": "LinkedIn company page if known."
          },
          "profileUrl": {
            "type": "string",
            "format": "uri",
            "description": "Public profile page on signals.gitdealflow.com."
          }
        },
        "required": [
          "rank",
          "name",
          "commitVelocityChange",
          "contributors",
          "signalType",
          "githubUrl"
        ]
      }
    },
    "citation": {
      "type": "string",
      "description": "Suggested citation string for reports."
    },
    "source": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "period",
    "startups",
    "citation",
    "source"
  ]
}

Every tracked startup within a sector, ranked by engineering acceleration. Sector slug must be one of 15 enumerated values.

{
  "type": "object",
  "properties": {
    "sector": {
      "type": "string",
      "enum": [
        "healthcare",
        "edtech",
        "ecommerce-infrastructure",
        "supply-chain",
        "web3",
        "enterprise-saas",
        "data-infrastructure",
        "robotics",
        "legal-tech",
        "hr-tech",
        "proptech",
        "agtech",
        "gaming",
        "space-tech",
        "social-community"
      ],
      "description": "Sector slug from the enumerated list. Map fuzzy user input to the closest slug (e.g. 'crypto' → 'web3', 'SaaS' → 'enterprise-saas').",
      "examples": [
        "healthcare",
        "web3",
        "gaming",
        "edtech"
      ]
    }
  },
  "required": [
    "sector"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "sector": {
      "type": "object",
      "description": "Sector metadata.",
      "properties": {
        "slug": {
          "type": "string",
          "description": "Sector slug."
        },
        "name": {
          "type": "string",
          "description": "Human-readable sector name."
        },
        "description": {
          "type": "string",
          "description": "One-line sector description."
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Sector landing page URL."
        }
      },
      "required": [
        "slug",
        "name"
      ]
    },
    "period": {
      "type": "string",
      "description": "Reporting period label."
    },
    "startupCount": {
      "type": "integer",
      "description": "Number of startups in this sector."
    },
    "startups": {
      "type": "array",
      "description": "Startups within the sector, ranked by engineering acceleration.",
      "items": {
        "type": "object",
        "description": "A single startup ranked by engineering acceleration, derived from public GitHub activity.",
        "properties": {
          "rank": {
            "type": "integer",
            "description": "1-indexed rank within this result set."
          },
          "name": {
            "type": "string",
            "description": "Startup or GitHub org name."
          },
          "sector": {
            "type": "string",
            "description": "Sector the startup is classified into."
          },
          "stage": {
            "type": "string",
            "description": "Funding stage if known (e.g. 'Seed', 'Series A', 'Unknown')."
          },
          "geography": {
            "type": "string",
            "description": "Headquarters region if known."
          },
          "commitVelocity14d": {
            "type": "number",
            "description": "Commits across tracked repos in the trailing 14 days."
          },
          "commitVelocityChange": {
            "type": "string",
            "description": "Percentage change in commit velocity vs. the prior 14-day window, e.g. '+142%'."
          },
          "contributors": {
            "type": "integer",
            "description": "Distinct contributors active in the last 30 days."
          },
          "contributorGrowth": {
            "type": "string",
            "description": "Percentage change in contributor count vs. the prior 30-day window."
          },
          "newRepos": {
            "type": "integer",
            "description": "New public repositories created in the last 30 days."
          },
          "signalType": {
            "type": "string",
            "description": "Classification label. Common values: 'breakout' (sudden surge), 'acceleration' (sustained growth), 'steady' (healthy baseline), 'cooling' (declining)."
          },
          "description": {
            "type": "string",
            "description": "One-line summary of the startup."
          },
          "githubUrl": {
            "type": "string",
            "format": "uri",
            "description": "Primary GitHub org URL."
          },
          "websiteUrl": {
            "type": "string",
            "format": "uri",
            "description": "Company website if known."
          },
          "linkedinUrl": {
            "type": "string",
            "format": "uri",
            "description": "LinkedIn company page if known."
          },
          "profileUrl": {
            "type": "string",
            "format": "uri",
            "description": "Public profile page on signals.gitdealflow.com."
          }
        },
        "required": [
          "rank",
          "name",
          "commitVelocityChange",
          "contributors",
          "signalType",
          "githubUrl"
        ]
      }
    },
    "citation": {
      "type": "string",
      "description": "Suggested citation string."
    },
    "error": {
      "type": "string",
      "description": "Present only when the sector slug is invalid."
    },
    "availableSectors": {
      "type": "array",
      "description": "When error is present, the full list of valid sector slugs.",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "period"
  ]
}

Full engineering-acceleration profile for a single tracked startup, by display name or GitHub org slug. Case-insensitive, normalization-tolerant.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Startup display name OR GitHub org name. Case-insensitive; punctuation and whitespace are ignored during matching.",
      "minLength": 1,
      "maxLength": 100,
      "examples": [
        "roboflow",
        "SkyPilot",
        "Supabase",
        "Hugging Face"
      ]
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "True when the startup is in the tracked universe; false is an expected outcome, not an error."
    },
    "startup": {
      "type": "object",
      "description": "A single startup ranked by engineering acceleration, derived from public GitHub activity.",
      "properties": {
        "rank": {
          "type": "integer",
          "description": "1-indexed rank within this result set."
        },
        "name": {
          "type": "string",
          "description": "Startup or GitHub org name."
        },
        "sector": {
          "type": "string",
          "description": "Sector the startup is classified into."
        },
        "stage": {
          "type": "string",
          "description": "Funding stage if known (e.g. 'Seed', 'Series A', 'Unknown')."
        },
        "geography": {
          "type": "string",
          "description": "Headquarters region if known."
        },
        "commitVelocity14d": {
          "type": "number",
          "description": "Commits across tracked repos in the trailing 14 days."
        },
        "commitVelocityChange": {
          "type": "string",
          "description": "Percentage change in commit velocity vs. the prior 14-day window, e.g. '+142%'."
        },
        "contributors": {
          "type": "integer",
          "description": "Distinct contributors active in the last 30 days."
        },
        "contributorGrowth": {
          "type": "string",
          "description": "Percentage change in contributor count vs. the prior 30-day window."
        },
        "newRepos": {
          "type": "integer",
          "description": "New public repositories created in the last 30 days."
        },
        "signalType": {
          "type": "string",
          "description": "Classification label. Common values: 'breakout' (sudden surge), 'acceleration' (sustained growth), 'steady' (healthy baseline), 'cooling' (declining)."
        },
        "description": {
          "type": "string",
          "description": "One-line summary of the startup."
        },
        "githubUrl": {
          "type": "string",
          "format": "uri",
          "description": "Primary GitHub org URL."
        },
        "websiteUrl": {
          "type": "string",
          "format": "uri",
          "description": "Company website if known."
        },
        "linkedinUrl": {
          "type": "string",
          "format": "uri",
          "description": "LinkedIn company page if known."
        },
        "profileUrl": {
          "type": "string",
          "format": "uri",
          "description": "Public profile page on signals.gitdealflow.com."
        }
      },
      "required": [
        "rank",
        "name",
        "commitVelocityChange",
        "contributors",
        "signalType",
        "githubUrl"
      ]
    },
    "suggestion": {
      "type": "string",
      "description": "When found=false, a hint on how to discover the correct name or alternative tools to call."
    },
    "citation": {
      "type": "string",
      "description": "Suggested citation string."
    }
  },
  "required": [
    "found"
  ]
}

Period, sector and startup counts, last refresh, citation, and direct URLs to every machine-readable format.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "description": "Current reporting period label."
    },
    "sectorsActive": {
      "type": "integer",
      "description": "Number of active sectors."
    },
    "startupsTracked": {
      "type": "integer",
      "description": "Total startups in the dataset."
    },
    "lastDataRefresh": {
      "type": "string",
      "description": "ISO 8601 timestamp of the last refresh."
    },
    "updateFrequency": {
      "type": "string",
      "description": "Human-readable update cadence."
    },
    "formats": {
      "type": "object",
      "description": "Direct URLs for every machine-readable format.",
      "properties": {
        "json": {
          "type": "string",
          "format": "uri"
        },
        "csv": {
          "type": "string",
          "format": "uri"
        },
        "rss": {
          "type": "string",
          "format": "uri"
        },
        "openapi": {
          "type": "string",
          "format": "uri"
        },
        "llmsTxt": {
          "type": "string",
          "format": "uri"
        },
        "llmsFullTxt": {
          "type": "string",
          "format": "uri"
        },
        "aiPolicy": {
          "type": "string",
          "format": "uri"
        },
        "agentCard": {
          "type": "string",
          "format": "uri"
        },
        "mcpManifest": {
          "type": "string",
          "format": "uri"
        },
        "agentsMd": {
          "type": "string",
          "format": "uri"
        },
        "nlweb": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "website": {
      "type": "string",
      "format": "uri"
    },
    "dashboard": {
      "type": "string",
      "format": "uri"
    },
    "citation": {
      "type": "string",
      "description": "Suggested citation string."
    }
  },
  "required": [
    "period",
    "sectorsActive",
    "startupsTracked",
    "lastDataRefresh",
    "formats",
    "citation"
  ]
}

Public-source diligence dossier for a company or entity in one cited object: who acquired it (M&A history), which funds publicly backed it, and its published engineering-acceleration signal. Use mid-diligence for 'who acquired X', 'which funds backed Y', 'what's the signal on Z'. Sources are press-release / SEC-filing / both-sides-disclosed only; returns found:false (an expected outcome, not an error) with honest notes when the entity is outside the tracked corpus, never guesses.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Company or entity name (target, acquirer, or tracked startup). Case-insensitive, normalization-tolerant.",
      "examples": [
        "Figma",
        "Supabase",
        "Broadcom",
        "Auth0"
      ]
    }
  },
  "required": [
    "company"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "description": "Resolved canonical entity name."
    },
    "found": {
      "type": "boolean",
      "description": "True when at least one grounded fact exists; false is an expected outcome, not an error."
    },
    "acquiredBy": {
      "type": "array",
      "description": "Public acquisitions where this entity was the target.",
      "items": {
        "type": "object",
        "properties": {
          "acquirer": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          },
          "announcedAmount": {
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "acquirerUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    },
    "acquisitionsMade": {
      "type": "array",
      "description": "If the entity is itself an acquirer: notable companies it has publicly bought.",
      "items": {
        "type": "object",
        "properties": {
          "target": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          },
          "announcedAmount": {
            "type": "string"
          },
          "note": {
            "type": "string"
          }
        }
      }
    },
    "backedBy": {
      "type": "array",
      "description": "Funds in our tracked corpus that publicly disclosed backing this entity.",
      "items": {
        "type": "object",
        "properties": {
          "fund": {
            "type": "string"
          },
          "fundUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    },
    "signal": {
      "type": [
        "object",
        "null"
      ],
      "description": "Published engineering-acceleration signal, when the entity is in the tracked corpus."
    },
    "notes": {
      "type": "array",
      "description": "Plain-language notes on what is and isn't known.",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "entity",
    "found"
  ]
}

Compute a Scout Score (0-100) for a GitHub user from their public starring history. Cross-references starred repos against ~75 validated unicorns and grades how many they starred *before* the validation event. Returns score, rank (curious/scout/sharp/elite/oracle), top early calls, personality summary, and a shareable card URL.

{
  "type": "object",
  "properties": {
    "github_username": {
      "type": "string",
      "minLength": 1,
      "maxLength": 39,
      "pattern": "^[a-zA-Z0-9](?:[a-zA-Z0-9]|-(?=[a-zA-Z0-9])){0,38}$",
      "description": "GitHub username, 1-39 chars, alphanumeric + single hyphens.",
      "examples": [
        "torvalds",
        "kindrat86",
        "tj"
      ]
    }
  },
  "required": [
    "github_username"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "GitHub username analysed."
    },
    "score": {
      "type": "number",
      "description": "Scout Score, 0-100. Higher means earlier+more validated calls."
    },
    "rank": {
      "type": "string",
      "description": "Rank label derived from the score: 'curious' | 'scout' | 'sharp' | 'elite' | 'oracle'."
    },
    "total_stars": {
      "type": "integer",
      "description": "Total public stars analysed."
    },
    "matched_count": {
      "type": "integer",
      "description": "Stars that match a validated unicorn in the database."
    },
    "early_count": {
      "type": "integer",
      "description": "Of the matches, how many were starred BEFORE the validation event."
    },
    "top_wins": {
      "type": "array",
      "description": "Top early calls ranked by points contribution.",
      "items": {
        "type": "object",
        "properties": {
          "org": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "repo": {
            "type": "string"
          },
          "event": {
            "type": "string",
            "description": "Validation event label."
          },
          "event_date": {
            "type": "string",
            "description": "ISO date of the validation event."
          },
          "starred_at": {
            "type": "string",
            "description": "ISO date of the star."
          },
          "months_early": {
            "type": "number",
            "description": "Months between star and validation event."
          },
          "weight": {
            "type": "number"
          },
          "points": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "event",
          "months_early",
          "points"
        ]
      }
    },
    "personality": {
      "type": "string",
      "description": "Optional one-line personality summary based on starring patterns."
    },
    "share_url": {
      "type": "string",
      "format": "uri",
      "description": "Shareable Scout Receipts page URL."
    },
    "og_image_url": {
      "type": "string",
      "format": "uri",
      "description": "OG/Twitter card image URL for sharing."
    }
  },
  "required": [
    "username",
    "score",
    "rank",
    "share_url"
  ]
}

Full methodology document covering data sources, metric computation, signal classification thresholds, refresh cadence, and known limitations.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "methodology": {
      "type": "string",
      "description": "Plain-text methodology covering sources, metrics, thresholds, cadence, and limitations."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Canonical methodology page on signals.gitdealflow.com."
    }
  },
  "required": [
    "methodology",
    "url"
  ]
}

PAID per-request, €0.19/call, 100 credits = €19 at https://signals.gitdealflow.com/agents/credits. Returns enriched signal beyond the free get_startup_signal: composite score (0-100), velocity/growth/novelty sub-scores, in-sector rank + percentile, plain-English investment thesis, top-3 sector comparables, and multi-period history. Requires Authorization: Bearer gdf_v2.cus_xxx.<hmac>. 1 credit consumed only on a successful match; misses are FREE. Credits never expire.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Startup display name or GitHub org slug."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "balance": {
      "type": "integer",
      "minimum": 0
    },
    "charged": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    },
    "scores": {
      "type": "object",
      "properties": {
        "velocity": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "growth": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "novelty": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "composite": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        }
      }
    },
    "thesis": {
      "type": "string"
    }
  },
  "required": [
    "found"
  ]
}

Generate a ready-to-share social-media post (tweet, Bluesky, Mastodon, LinkedIn, Telegram) about a result the user just received from another VC Deal Flow Signal tool, plus the install command for the MCP server. Returns the post body, character counts per platform, and one-click intent URLs to compose the post in each network. WHEN TO USE: - The user just got a `get_trending_startups` / `search_startups_by_sector` / `get_startup_signal` / `get_deep_signal` result and says 'share this', 'tweet this', 'post this', or 'how do I tell people about this?'. - The user is writing a thread/post about startup engineering signals and wants the canonical install command + share copy. DO NOT USE FOR: - Posting on the user's behalf, this tool only composes the text + intent URLs. The user must click and confirm in the destination network. - Generating fake or speculative results, pass real data the agent received from another tool call. BEHAVIOR (two-step approval flow, see `approval_token`): - Step 1: call this tool with `summary` only. The server replies with an error (-32602) containing a `/share-approve?summary=...` URL the user must open. - Step 2: the user reads the proposed summary on that page, clicks Approve, and pastes the resulting 10-minute token back into the chat. Retry the tool with `approval_token` filled in and the SAME `summary` verbatim. - The token is bound to a hash of `summary`; if the agent rewrites the summary between approval and the retry, the call is rejected. - Composes platform-specific posts (Twitter ≤275 chars, Bluesky ≤295, Mastodon ≤495, LinkedIn ≤695, Telegram ≤995) with a consistent hook + insight + install URL. - Returns intent URLs (e.g. https://x.com/intent/post?text=...) so the user/agent can open the destination network with the post pre-filled. - Always includes the canonical install command `npx @gitdealflow/mcp-signal` and the SSRN paper link for credibility. PARAMETERS: - `summary` (string, required, 10-200 chars), the one-line takeaway to share. - `approval_token` (string, required after first call), the 10-minute token returned by the /share-approve page. - `network` (string, optional), 'twitter' | 'bluesky' | 'mastodon' | 'linkedin' | 'telegram' | 'all' (default: 'all'). - `mention_handle` (boolean, optional, default false), include @sipiteno attribution (twitter/bluesky/mastodon only).

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "minLength": 10,
      "maxLength": 200,
      "description": "One-line takeaway (10-200 chars) the user wants to share."
    },
    "approval_token": {
      "type": "string",
      "minLength": 16,
      "maxLength": 512,
      "description": "10-minute HMAC-signed token bound to a hash of `summary`. Obtain it by directing the user to https://signals.gitdealflow.com/share-approve?summary=<urlencoded-summary>they review and click Approve, then paste the resulting token back. The first call with no token will return an error containing the exact URL to send the user to."
    },
    "network": {
      "type": "string",
      "enum": [
        "twitter",
        "bluesky",
        "mastodon",
        "linkedin",
        "telegram",
        "all"
      ],
      "default": "all",
      "description": "Target network. 'all' returns one post per network."
    },
    "mention_handle": {
      "type": "boolean",
      "default": false,
      "description": "Include @sipiteno attribution. Only applied to twitter/bluesky/mastodon."
    }
  },
  "required": [
    "summary",
    "approval_token"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "posts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "network": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "charCount": {
            "type": "number"
          },
          "intentUrl": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "network",
          "body",
          "charCount",
          "intentUrl"
        ]
      }
    },
    "installCommand": {
      "type": "string"
    },
    "methodologyUrl": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "posts",
    "installCommand",
    "methodologyUrl"
  ]
}

Transparent, scored funding-likelihood claim for one tracked startup, with the full evidence chain and citable provenance. Instead of an opaque number, returns the score, every component that produced it, a confidence level, honest caveats, and links to the methodology + SSRN paper so the derivation can be cited. IS a deterministic heuristic over public GitHub engineering-acceleration signals; IS NOT an ML black box, a guarantee of any financing event, or based on private/cap-table data. The disclaimer is returned in every response. SCORING (also returned in evidence.scoreBreakdown): velocity ≤40 (saturates +300%), contributorGrowth ≤25 (saturates +200%), newRepos ≤15 (saturates 10), signalType ≤20 (Deploy frequency spike 20 / Engineering hiring burst 17 / Infrastructure buildout 14 / Framework migration 8). Total 0-100 → >=70 high, 45-69 elevated, 25-44 moderate, <25 low. PARAMETERS: { name }, display name or GitHub org slug (case-insensitive). On no match returns { found: false, suggestion } (expected, not an error).

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Startup display name or GitHub org slug. Case-insensitive.",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "company": {
      "type": "object"
    },
    "prediction": {
      "type": "object",
      "properties": {
        "claim": {
          "type": "string"
        },
        "raiseLikelihood": {
          "type": "string",
          "enum": [
            "high",
            "elevated",
            "moderate",
            "low"
          ]
        },
        "accelerationScore": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "estimatedWindow": {
          "type": "string"
        },
        "confidence": {
          "type": "string",
          "enum": [
            "high",
            "moderate",
            "low"
          ]
        }
      }
    },
    "evidence": {
      "type": "object"
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "provenance": {
      "type": "object",
      "properties": {
        "methodologyUrl": {
          "type": "string",
          "format": "uri"
        },
        "researchPaperUrl": {
          "type": "string",
          "format": "uri"
        },
        "citation": {
          "type": "string"
        },
        "source": {
          "type": "string",
          "format": "uri"
        },
        "period": {
          "type": "string"
        }
      },
      "required": [
        "methodologyUrl",
        "researchPaperUrl",
        "citation",
        "source"
      ]
    },
    "disclaimer": {
      "type": "string"
    },
    "suggestion": {
      "type": "string"
    }
  },
  "required": [
    "found",
    "provenance",
    "disclaimer"
  ]
}

Return a ranked shortlist of the strongest engineering-acceleration signals matching a set of filters, the whole sourcing workflow in ONE call (e.g. 'the 5 strongest signals in healthcare in the EU'). Scans the full tracked universe, scores each with the transparent engine (same scoring as predict_funding), filters, sorts by accelerationScore desc, returns the top `limit`. GEOGRAPHY IS REGION-LEVEL ONLY, values are US / EU / UK / APAC / LATAM / Canada / Unknown. City/country aliases ('NYC', 'New York', 'London', 'Berlin', 'Singapore') normalize up to the enclosing region and the response `notes` says so. There is no city-level filtering. PARAMETERS (all optional): sector (one of 20 slugs), geography (region token or alias), signalType (exact label), minAccelerationScore (0-100), minVelocityChangePct (integer percent), limit (1-25, default 5).

{
  "type": "object",
  "properties": {
    "sector": {
      "type": "string",
      "enum": [
        "healthcare",
        "edtech",
        "ecommerce-infrastructure",
        "supply-chain",
        "web3",
        "enterprise-saas",
        "data-infrastructure",
        "robotics",
        "legal-tech",
        "hr-tech",
        "proptech",
        "agtech",
        "gaming",
        "space-tech",
        "social-community"
      ]
    },
    "geography": {
      "type": "string",
      "description": "Region token (US/EU/UK/APAC/LATAM/Canada) or a city/country alias normalized up to the region."
    },
    "signalType": {
      "type": "string",
      "enum": [
        "Deploy frequency spike",
        "Engineering hiring burst",
        "Infrastructure buildout",
        "Framework migration"
      ]
    },
    "minAccelerationScore": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "minVelocityChangePct": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 5
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "object"
    },
    "period": {
      "type": "string"
    },
    "consideredCount": {
      "type": "integer"
    },
    "matchedCount": {
      "type": "integer"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "citation": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "format": "uri"
    },
    "methodologyUrl": {
      "type": "string",
      "format": "uri"
    },
    "disclaimer": {
      "type": "string"
    }
  },
  "required": [
    "query",
    "period",
    "matchedCount",
    "results",
    "citation"
  ]
}

Score and rank 2-5 named startups side by side, returning each one's acceleration score, evidence, and raise-likelihood band plus a single recommendation for which warrants deeper diligence. Same transparent scoring as predict_funding / shortlist_signals. Names that don't resolve are returned in `notFound` (expected, not an error). The recommendation is computed only over resolved companies; if fewer than 2 resolve it explains that no comparison was possible. PARAMETERS: { names: string[] }, 2 to 5 display names or GitHub org slugs (case-insensitive).

{
  "type": "object",
  "properties": {
    "names": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "minItems": 2,
      "maxItems": 5
    }
  },
  "required": [
    "names"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string"
    },
    "compared": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "notFound": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recommendation": {
      "type": "string"
    },
    "citation": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "format": "uri"
    },
    "methodologyUrl": {
      "type": "string",
      "format": "uri"
    },
    "disclaimer": {
      "type": "string"
    }
  },
  "required": [
    "period",
    "compared",
    "recommendation",
    "citation"
  ]
}