Stdio bridge for a hosted Streamable HTTP MCP server from Sourcey. It enables clients that require a local command to access Sourcey functionality for startup offers/credits, inspect Agent Readiness report cards, and prepare canonical service declarations from an agent client.

🛠️ Key Features

Provides a thin stdio bridge that targets Sourcey’s hosted MCP endpoint
Exposes startup credits and deals using evidence-backed information
Supports inspecting Agent Readiness report cards
Prepares canonical service declarations from an agent client

🚀 Use Cases

Query evidence-backed startup credits and deals
Review Agent Readiness report cards during agent evaluation
Generate canonical service declarations within an agent workflow

⚡ Developer Benefits

Works with MCP clients that need a local command via npx -y @sourcey/mcp-server
Uses the hosted remote MCP URL when supported: https://mcp.sourcey.com/mcp

⚠️ Limitations

Documented as a local stdio bridge to the hosted Streamable HTTP MCP server; remote support is handled by using the provided URL instead

Sourcey MCP Server

Find evidence-backed startup credits and deals, inspect Agent Readiness report cards, and prepare canonical service declarations from an agent client.

Sourcey is already a hosted Streamable HTTP MCP server:

text

https://mcp.sourcey.com/mcp

Use that URL directly when your client supports remote MCP. This package is the thin stdio bridge for clients that require a local command:

bash

npx -y @sourcey/mcp-server

json

{
  "mcpServers": {
    "sourcey": {
      "command": "npx",
      "args": ["-y", "@sourcey/mcp-server"]
    }
  }
}

The bridge downloads no Catalog and contains no tool implementations. At startup it negotiates with the live Sourcey server, reads the current tool definitions once, and relays tool calls. A Catalog or tool-description update therefore needs no package release.

What agents can do

search and compare current startup credits, discounts, free tiers, programs, perks, and deals;

inspect exact evidence, freshness, eligibility unknowns, and the signed change feed;

search and inspect Agent Readiness report cards, including visible grades, five-stage findings, blockers, remediations, methods, coverage, and freshness;

prepare canonical Agent Readiness declaration YAML without assigning a grade; and

discover Sourcey's paid HTTP services and x402 endpoint without paying inside MCP.

Call tools/list for the exact live schemas and descriptions. Sourcey's full agent guide is at sourcey.com/SKILL.md, its OpenAPI contract is at api.sourcey.com/openapi.yml, and x402 discovery is at api.sourcey.com/.well-known/x402.

Boundary

This package performs only two actions: MCP over local stdio and MCP over the configured hosted HTTP endpoint. It has no wallet, payment signer, credentials, telemetry, browser, background daemon, mutable plugin, Catalog data, Agent Readiness executor, or submission authority. Paid work remains on Sourcey's canonical HTTP API.

SOURCEY_MCP_URL may select another HTTPS Sourcey endpoint. Plain HTTP is accepted only for a loopback test server. URLs containing credentials or fragments are refused.

Development

bash

npm ci
npm run verify
docker build -t sourcey-mcp .

The verification path builds from clean output, checks all generated metadata, tests the real HTTP-to-stdio boundary, creates an SBOM, installs the exact packed tarball into a blank project, and repeats protocol introspection from those installed bytes.

MIT. See SECURITY.md and SUPPORT.md for reporting paths.

Sourcey