V-Sum developers

V-Sum publishes machine-readable interfaces so agents and integrations can work with our technical briefings, interviews, and convening archive without scraping HTML. This hub collects predictable URLs, auth notes, and official client packages named for search and package registries.

Quick links

— Public Data API (api.v-sum.com) — read-only JSON, no auth
— OpenAPI 3.1 (openapi.json)
— RFC 9727 API catalog
— MCP endpoint (POST JSON-RPC; server card below)
— MCP server card
— llms.txt and llms-full.txt
— RSS feed (feed.xml; aliases /rss, /rss.xml)
— Agent skills (skills.sh-compatible)
— Human-readable API notes
— Service status

API keys and sandbox

There is no public API key product today. Read-only automation should use the MCP server (no auth) or GET /api/health for probes. Staff operator APIs under /api/admin/* and related routes require a Google OAuth session issued after console sign-in — treat the signed-in browser as your “sandbox” for those routes. The attendee portal uses a separate magic-link session for a small set of /api/portal/* routes.

MCP (Model Context Protocol)

POST https://v-sum.com/mcp speaks JSON-RPC 2.0 over the MCP streamable HTTP transport (2025-06-18). Clients must send Accept: application/json, text/event-stream per the MCP spec. Lifecycle notifications (for example notifications/initialized) receive HTTP 202 Accepted with an empty body. MCP Apps: tools All read tools advertise _meta.ui.resourceUri pointing at ui://v-sum/briefing-browser; hosts may fetch it via resources/read.

Official SDK packages

Minimal first-party clients live in this repository under packages/. Regenerate typed clients any time from openapi.json using openapi-generator.

— npm: v-sum (alias) — npm install v-sum
— npm: vsum-api-client (ESM, canonical) — npm install vsum-api-client
— npm: vsum-cli — npm install -g vsum-cli
— PyPI: vsum-api-client — pip install vsum-api-client
— Go: vsum-sdk-go — go get github.com/superduperdot/vsum-sdk-go

CLI

The vsum binary (package vsum-cli) calls GET /api/health by default. From a clone of this repo:

npm install
cd packages/vsum-cli && npm link
vsum health

AI coding agents

This repository ships an AGENTS.md with contributor guidance for AI coding agents. Cursor users will also find project rules under .cursor/rules/.

Agent skills (skills.sh)

V-Sum publishes reusable skills.sh-compatible skills so AI coding agents (Claude Code, Cursor, Codex, OpenCode, and 40+ others) can research fintech briefings and connect to the V-Sum MCP server with one command.

npx skills add superduperdot/vsum-skills

— fintech-briefings-research — primary-source research over the V-Sum archive
— vsum-mcp-client — wiring the V-Sum MCP server into any streamable-HTTP MCP client
— Source: github.com/superduperdot/vsum-skills

Feeds

The RSS feed at /feed.xml (also reachable at /rss and /rss.xml) serves every published technical briefing with the presentation date as pubDate, a link to the briefing page, and the YouTube URL as an <enclosure>. Auto-discovered via a <link rel="alternate" type="application/rss+xml"> on every page, so any RSS reader picks it up from v-sum.com. No subscribe endpoint, no delivery guarantees — pull the feed on your schedule.

Rate limits and errors

Selected routes enforce per-IP limits and return 429 with a Retry-After header (seconds). Unknown /api/* paths return 404 with JSON bodies including error: "not_found" instead of masking as 401. Operator calls without a session return 401 with error: Unauthorized. See openapi.json for shared error schemas.