API Documentation

Everything you need to integrate VC Deal Flow Signal into your workflow. All APIs are free and require no authentication. No API key, no signup, no rate limits.

📋 Endpoints

REST API

Base URL: https://signals.gitdealflow.com

GET /api/signals.json

Returns the full VC Deal Flow Signal dataset as a JSON array. Each entry contains startup name, sector, velocity score, contributor count, commit count, and acceleration rating.

curl
curl https://signals.gitdealflow.com/api/signals.json

Optional query parameters:

?sector=fintech # Filter by sector slug ?limit=10 # Limit results ?sort=velocity # Sort by velocity score
GET /api/startup/{name}

Get detailed signal data for a specific startup. The name is case-insensitive and supports fuzzy matching.

curl
curl https://signals.gitdealflow.com/api/startup/posthog
GET /api/sector/{slug}

Filter startups by sector. Available sectors: fintech, ai-ml, developer-tools, cybersecurity, healthcare, climate-tech, enterprise-saas, data-infrastructure, web3, robotics, edtech, ecommerce-infrastructure, supply-chain, legal-tech, hr-tech, proptech, agtech, gaming, space-tech, social-community.

curl
curl https://signals.gitdealflow.com/api/sector/fintech

MCP Server

MCP stdio + Streamable HTTP

The Model Context Protocol server provides six read-only tools for AI agents. All tools are idempotent and require no authentication.

Installation (stdio):

npx -y @gitdealflow/mcp-signal

HTTP mode:

POST https://signals.gitdealflow.com/api/mcp/rpc

Available tools:

get_trending_startups # Top 20 across all sectors search_startups_by_sector # Filter by sector slug get_startup_signal # Individual startup details get_signals_summary # Dataset overview get_scout_receipts # Scout Score for a GitHub user get_methodology # Full methodology

A2A Agent Protocol

POST /api/a2a

Google A2A-compatible JSON-RPC 2.0 endpoint for agent-to-agent communication. Accepts structured queries and returns startup signal data.

curl
curl -X POST https://signals.gitdealflow.com/api/a2a \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"get_trending","params":{},"id":1}'

NLWeb Endpoint

POST /api/nlweb

Microsoft NLWeb-compatible conversational endpoint. Accepts natural-language queries, returns schema.org-typed JSON-LD answers.

curl
curl -X POST https://signals.gitdealflow.com/api/nlweb \ -H "Content-Type: application/json" \ -d '{"query": "trending fintech startups this week"}'

Function-Calling API

GET /api/agent/tools

OpenAPI-compatible function definitions for use with OpenAI, Anthropic, or Gemini SDKs. Returns tool schemas that can be directly passed as function definitions.

curl
# Get tool definitions curl https://signals.gitdealflow.com/api/agent/tools # Call a tool curl -X POST https://signals.gitdealflow.com/api/agent/call \ -H "Content-Type: application/json" \ -d '{"tool":"get_trending_startups","args":{}}'

CSV Export

GET /api/signals.csv

Download the full dataset as CSV for use in spreadsheets, Python, R, or any data analysis tool.

curl
curl https://signals.gitdealflow.com/api/signals.csv

Code Examples

Python
import requests # Fetch all signals data = requests.get( "https://signals.gitdealflow.com/api/signals.json" ).json() # Filter for fintech fintech = [s for s in data if s.get("sector") == "fintech"] print(f"Found {len(fintech)} fintech startups")
JavaScript / Node.js
const data = await fetch( "https://signals.gitdealflow.com/api/signals.json" ).then(r => r.json()); console.log(`Tracking ${data.length} startups`);
MCP (Claude Desktop / Cursor)
// Add to your MCP client config: { "mcpServers": { "vc-deal-flow-signal": { "command": "npx", "args": ["-y", "@gitdealflow/mcp-signal"] } } }

Frequently Asked Questions

No. All GitDealFlow APIs — REST, MCP, A2A, and NLWeb — are free and require no authentication. No signup, no API key, no rate limiting for reasonable use.
We offer eight surfaces: signals.json (full dataset), search, startup details, sector filter, MCP server (stdio and HTTP), A2A agent protocol, NLWeb endpoint, and function-calling API. All documented in this page.
We do not enforce strict rate limits for reasonable use. The API is designed for free access during evaluation. Enterprise plans offer dedicated rate limits of up to 10,000 requests/hour.
The REST API returns JSON. A CSV export is available at /api/signals.csv. The MCP server returns structured tool results. The A2A endpoint uses JSON-RPC 2.0 format.
The dataset refreshes every Sunday with the latest week's velocity signals. The signals.json endpoint always returns the most current data.
Yes. The MCP server works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible host. Use npx -y @gitdealflow/mcp-signal for stdio mode or POST https://signals.gitdealflow.com/api/mcp/rpc for HTTP mode.

Ready to Build?

Try the API right now with curl — no signup needed. Or subscribe for the Sunday email digest.

Get the Sunday Email →

Or upgrade to premium data exports