Skip to content
░V-Sum

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

API keys and auth

Public endpoints (data API, public MCP) require no auth. Staff operator APIs under /api/admin/* accept either a Google OAuth session (browser sign-in) or a staff API token (Authorization: Bearer stk_...). Staff tokens are issued on the admin Team page with configurable access levels (read, write, operate). The admin MCP server at /mcp/admin accepts staff tokens only. The attendee portal uses a separate OTP session for /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.

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

Agent Operations (Admin MCP)

V-Sum exposes an authenticated admin MCP server at POST https://v-sum.com/mcp/admin for programmatic operational control. Agent teams can manage events, CRM, sponsors, billing, communications, tasks, and content via MCP tools with approval gates on sensitive actions.

Authentication: Bearer token via staff API keys (Authorization: Bearer stk_...). Tokens are issued by an admin on the Team page. Contact [email protected] to request access.

Access levels:

Tool domains: events, people, tasks, registrations, sponsors, communications, content, analytics, system (~35 tools).

Approval gates: Stripe invoices, external emails, content publishing, and deal value changes require human approval. The agent creates an approval request and polls for resolution.

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

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.