# V-Sum MCP Server

Read-only [Model Context Protocol](https://modelcontextprotocol.io) server for **V-Sum** — technical briefings, interviews, events, and company data from the companies building the future of finance.

No authentication required. JSON-RPC 2.0 over streamable HTTP.

## Connect

```
Server URL: https://v-sum.com/mcp
Transport:  Streamable HTTP (POST JSON-RPC 2.0)
Auth:       None
Protocol:   2025-06-18
```

### Claude Desktop / Cursor

Add to your MCP config:

```json
{
  "mcpServers": {
    "v-sum": {
      "url": "https://v-sum.com/mcp"
    }
  }
}
```

### Glama

Type in [Glama chat](https://glama.ai/chat):

```
@v-sum search for payments briefings
```

## Tools

| Tool | Description |
|------|-------------|
| `search_briefings` | Full-text search across V-Sum technical briefings |
| `get_briefing` | Single briefing with metadata and timestamped chapters |
| `list_briefings` | Paginated briefing list, filterable by event or tag |
| `list_events` | V-Sum convenings in chronological order |
| `list_companies` | Companies that have given a technical briefing |

### search_briefings

```json
{ "query": "string (required)", "limit": "integer (optional)" }
```

### get_briefing

```json
{ "slug": "string (required)" }
```

### list_briefings

```json
{ "event": "string (optional)", "tag": "string (optional)", "limit": "integer (optional)", "offset": "integer (optional)" }
```

### list_events / list_companies

No parameters required.

## MCP Apps

The `search_briefings` and `get_briefing` tools expose `_meta.ui.resourceUri` pointing to `ui://v-sum/briefing-browser`. Hosts that support MCP Apps can fetch this resource via `resources/read` to render an inline briefing UI.

## Discovery

| Endpoint | URL |
|----------|-----|
| MCP Server | https://v-sum.com/mcp |
| Server Card | https://v-sum.com/.well-known/mcp/server-card.json |
| MCP Discovery | https://v-sum.com/.well-known/mcp |
| Developer Hub | https://v-sum.com/developers |
| Public Data API | https://api.v-sum.com |
| OpenAPI Spec | https://api.v-sum.com/spec.json |
| llms.txt | https://v-sum.com/llms.txt |

## SDK Packages

- **npm**: [`vsum-api-client`](https://www.npmjs.com/package/vsum-api-client) — `npm install vsum-api-client`
- **npm**: [`vsum-cli`](https://www.npmjs.com/package/vsum-cli) — `npm install -g vsum-cli`
- **PyPI**: [`vsum-api-client`](https://pypi.org/project/vsum-api-client/) — `pip install vsum-api-client`

## About V-Sum

V-Sum is a curated finance media and convening company. We surface the companies building the future of finance through technical briefings, curated convenings, and a growing archive — not job prep or recruiter content.

- [v-sum.com](https://v-sum.com)
- [YouTube](https://www.youtube.com/@V-Sum)
- [LinkedIn](https://www.linkedin.com/company/72569134)

## License

MIT