dc

# DC Official Client

The official Python client for the [Dynamite Circle Member API](https://www.dynamitecircle.com/developers/) — your own profile, trips, events, virtual events, tickets, invites, inbox, rooms, chapters, places lookup, and the weekly locator digest.

A single self-contained file. Zero dependencies (stdlib only). Works as a CLI, a Python library, **and** a [Model Context Protocol](https://modelcontextprotocol.io) server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.

```
py/dc.py    ← one file, three integration modes
```

## About the Dynamite Circle

The [Dynamite Circle](https://www.dynamitecircle.com/?utm_medium=github&utm_source=dc-official&utm_campaign=client-repo) is **the place where global founders find their people** — a curated, members-only community of location-independent business owners running profitable companies around the world. Founded in 2011 (it started with twenty listeners on a remote tropical island), the DC has grown into a hand-selected network of ~1,500 active founders who meet at vetted in-person events like [DCBKK](https://www.dynamitecircle.com/dcbkk/) and DCMEX, swap notes in private rooms, and travel through each other's home cities year-round.

DC is a private community, but it's open to applications from founders running location-independent businesses doing $100k+ in annual revenue. Every application is personally reviewed by a team member within 48 business hours — [start an application here](https://dc.dynamitecircle.com/account/apply?utm_medium=github&utm_source=dc-official&utm_campaign=client-repo&referrer=github.com) if that sounds like you.

## Quick Start

Never used Claude Code, Codex, or git? Here's the 5-minute path from zero to "Claude can read my DC profile."

### 1. Install the basics (one-time)

You need three free things on your computer:

- **Python 3.9+** — the language this client is written in. [Download here](https://www.python.org/downloads/) (Mac/Windows/Linux installers; check **"Add Python to PATH"** on Windows).
- **Git** — the tool that downloads code from GitHub. [Download here](https://git-scm.com/downloads).
- **An AI assistant** — pick one:
  - **[Claude Code](https://claude.com/product/claude-code)** ← *recommended* — this repo is built around it
  - **[Codex CLI](https://github.com/openai/codex)** — works too, slightly different commands
  - **[Claude Desktop](https://claude.ai/download)** — the chat app, gets you the MCP server but no CLI

If anything during install asks "do you want to add to PATH?" — say yes.

### 2. Get the code

Open a terminal:
- **Mac**: Spotlight → "Terminal"
- **Windows**: Start → "Terminal" (or "PowerShell")
- **Linux**: you know what to do

Then paste:

```bash
git clone https://github.com/dynamitecircle/dc.git
cd dc
```

You now have a folder called `dc` with all the code in it.

### 3. Get your DC API key

In your browser: go to **https://dc.dynamitecircle.com**, log in, click your profile photo (top-right), and choose **DC Member API Key**. Copy the long string starting with `dk_…`.

### 4. Tell the client about your key

Back in your terminal (still inside the `dc` folder):

```bash
python3 py/dc.py setup --api-key dk_paste_your_key_here
```

### 5. Try it

Open **Claude Code** and make sure it's pointed at the `dc` folder you just downloaded. (Claude usually opens to your last project — if it's somewhere else, click the folder icon and pick `dc`.)

Then ask:

> "Show me my DC profile"

Claude runs the right command and shows you back your profile. A few more to try:

> "What's the latest in DC announcements?"
> "What events am I attending?"
> "Show me the DCMEX schedule and bookmark anything about marketing"
> "Who else from my chapter is going to DCBKK?"

You're done. The rest of this README explains what's possible in more detail; [`py/SKILL.md`](py/SKILL.md) lists every command Claude can run.

### If something didn't work

| Symptom | What to try |
|---|---|
| `python3: command not found` | Python didn't install or didn't get added to PATH. Re-install and check the **"Add to PATH"** box on Windows; on Mac, try `python` instead of `python3`. |
| `git: command not found` | Same idea — re-install Git. |
| Claude says "I don't see a `dc` skill" | Make sure Claude Code is opened to the `dc` folder, not your home directory or another project. Or just ask Claude: *"are you in the dc folder?"* |
| Anything else | Run `python3 py/dc.py self-test` from the `dc` folder — it tells you exactly which step is broken. |

---

## How it's exposed

The same `dc.py` file is shipped as **four** integrations — pick whichever fits how your tool talks to it:

| Integration | What it is | Invoke with | Dependencies |
|---|---|---|---|
| **Agent Skill** | Auto-discovered via `SKILL.md` frontmatter (Claude Code, Codex, Gemini CLI, Cursor, Copilot) | Just open the repo with the tool — it reads [`py/SKILL.md`](py/SKILL.md) and offers the commands | stdlib only |
| **CLI** | Run commands directly from the shell or scripts | `python3 py/dc.py <command>` | stdlib only |
| **Python library** | Import in your own Python code | `from dc import DC; DC().profile()` | stdlib only |
| **MCP server** | Speaks Model Context Protocol over stdio (Claude Desktop, Cursor, Codex MCP, Cline, etc.) | `python3 py/dc.py --mcp` | `pip install mcp` (optional) |

The `mcp` package is **lazy-imported** — Agent Skill / CLI / Python-library users never need it.

### Don't want to install anything? Use the hosted MCP

The DC Member API is **also a hosted MCP server** — a remote endpoint you point your AI app at, with nothing to clone, install, or update:

```
https://api.dynamitecircle.com/mcp        (Streamable HTTP)
```

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=dc&config=eyJ1cmwiOiJodHRwczovL2FwaS5keW5hbWl0ZWNpcmNsZS5jb20vbWNwIn0=)
&nbsp;
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_DC-007ACC?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=dc&config=%7B%22url%22%3A%22https%3A%2F%2Fapi.dynamitecircle.com%2Fmcp%22%7D)

- **Claude Code:** `claude mcp add --transport http dc https://api.dynamitecircle.com/mcp`
- **Claude (web / Desktop / mobile):** Settings → Connectors → **Add custom connector** → paste the URL → **Connect**
- **VS Code:** click the badge above, or `code --add-mcp '{"name":"dc","url":"https://api.dynamitecircle.com/mcp"}'`
- **Cursor:** click the badge above, or add a custom MCP connector pointing at the URL
- **ChatGPT / any other MCP app:** add a custom / remote MCP connector pointing at the URL above

When prompted, **sign in with your DC account** (one-click OAuth) — or send a `dk_` key as `Authorization: Bearer`. The server is always on the current API version, so there's nothing to keep up to date.

**Hosted MCP vs. this client — which do I want?**

| You want… | Use |
|---|---|
| Zero install, always-current, just MCP tools in a chat app | **Hosted MCP** (URL above) |
| To call DC from your own Python code (`from dynamitecircle import DC`) | **This client** (library) |
| A local CLI (`dc profile`) or shell scripting | **This client** (CLI) |
| A local stdio MCP server (offline-capable, pin a version, dev against localhost) | **This client** (`dc --mcp`) |

The rest of this README is about **this client**. For the hosted MCP, the URL above is all you need.

## Features

- **Full Member API coverage** — read + write across every public endpoint (run `python3 py/dc.py help` for the live list)
- **Setup command** — saves your API key to a chmod-600 `.env.dc` next to the skill
- **Self-test command** — validates env, network, key shape, and a live `/profile` call end-to-end
- **Cursor pagination** — every list-returning command uses the same `[--limit N] [--cursor TOKEN]` shape and returns the canonical envelope `{items, count, cursor, has_more}`
- **Three output formats** — text (default, pretty JSON), `--json`, `--python`
- **MCP-ready** — same skill auto-exposes all commands as MCP tools
- **Pre-configured for Claude Code** — repo ships an `.mcp.json`, just `cd` and `claude`

## CLI quickstart (already comfortable in a terminal?)

If you're skipping past the [Quick Start](#quick-start) above and just want the CLI flow, here's the condensed version.

### 1. Get an API key

DC profile dropdown → **DC Member API Key** (admins/testers only). Keys look like `dk_<api-key>` and are revocable from the same dropdown.

### 2. Save the key

```bash
python3 py/dc.py setup --api-key dk_<api-key>
```

This writes `py/.env.dc` (chmod 600, gitignored).

### 3. Verify the connection

```bash
python3 py/dc.py self-test
```

Expected output:

```json
{
  "ok": true,
  "userID": "<your-id>",
  "displayName": "<Your Name>",
  "checks": [
    { "step": "env",      "ok": true, "message": "DC_API_KEY loaded from ..." },
    { "step": "keyShape", "ok": true, "message": "Key prefix valid (expected userID: <id>)" },
    { "step": "profile",  "ok": true, "message": "connected as userID[<id>] <Your Name>" }
  ]
}
```

### 4. Try a few commands

```bash
python3 py/dc.py profile
python3 py/dc.py trips --limit 5
python3 py/dc.py events --past --limit 3
python3 py/dc.py chapters --limit 5
python3 py/dc.py permacode
```

Run `python3 py/dc.py help` for the full command list.

## Setup per AI tool

### Hosted MCP (no install, always current)

Nothing to clone or update — point your tool at the remote endpoint:

```bash
# Claude Code
claude mcp add --transport http dc https://api.dynamitecircle.com/mcp
```

For Claude web / Desktop, Cursor, ChatGPT, and other MCP apps, add a **custom / remote connector** pointing at `https://api.dynamitecircle.com/mcp` (Streamable HTTP). Sign in with your DC account (OAuth) or send a `dk_` key as a Bearer header. Discovery is published at [`/.well-known/mcp.json`](https://api.dynami