Dynamite Circle Alerts API
The Alerts API from Dynamite Circle — 2 operation(s) for alerts.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/dynamitecircle-com:dynamitecircle-com-alerts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
name: DC Team
url: https://dc.dynamitecircle.com
description: 'Programmatic access to your DC membership data — trips, events, profile, announcements, and more. Designed for AI assistants, automation, and personal integrations. > **For ALL active DC members.** Every active DC member is eligible from day one — DC, DC BLACK, and trial accounts alike. ## What this is for
The DC Member API is for **personal use** — wiring DC into your own AI assistant, scripting personal automations, pulling your own data into your own dashboards. Think "give my Claude/Codex/Cursor access to my DC trips and announcements" or "auto-update my DC trip when I book a flight."
**It is not for:**
- Building apps that other DC members log into (use the official DC app)
- Crawling, scraping, or bulk-exporting member data
- Building an alternative DC client
- Public-facing services running on top of the API
We **augment, we don''t replace** — the API gives you awareness and convenience, then sends you to the app for the real interactions. Human stuff stays in the app: no message content, no DM access, no bulk profile browsing, no discussion threads. **Rate limits are strict on purpose.** They''re sized for personal automation, not application traffic. We''ll loosen them once we see real usage patterns — if you hit a wall, email the DC developer team at **bugs+api@dynamitecircle.com** and we''ll sort you out. ## Connect to Claude & other AI apps (hosted MCP)
This API is also a hosted MCP server — add it as a connector in Claude, Cursor, ChatGPT, or any MCP-compatible app and your assistant can read and act on your DC data directly. **No install.** When prompted, **sign in with your DC account** (one-click OAuth) — or paste a `dk_` API key. Every endpoint below is exposed as a tool. **Connector URL** (Streamable HTTP): `https://api.dynamitecircle.com/mcp`
- **Claude (web, Desktop & mobile):** Settings → Connectors → **Add custom connector** → paste the URL → **Connect**, then sign in with your DC account. (Paid Claude plan; on Team/Enterprise an admin may need to approve it first.)
- **Claude Code:** `claude mcp add --transport http dc https://api.dynamitecircle.com/mcp`
- **Cursor, ChatGPT & other MCP apps:** add a custom / remote MCP connector pointing at the URL above (Streamable HTTP). Discovery is published at `/.well-known/mcp.json`. **What you can do once connected** — ask in plain language, e.g. "Which DCBKK sessions have I bookmarked?", "Add a trip to Lisbon and show me which DCers will be around", "RSVP me to the next Bangkok meetup", "Summarize the latest announcements." Reads run freely; writes do exactly what the matching endpoint documents. Access is scoped to **you** — the connector only ever sees your own membership data. ## Official client — Agent Skill, CLI, Python library, MCP server
The fastest way to use this API — and to plug it into Claude Code, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, or Claude Desktop — is the **official DC client**. One self-contained Python file, stdlib only, that ships as **four integrations from the same source**: Agent Skill (auto-discovered via SKILL.md), CLI (`dc …`), Python library (`from dc import DC`), and MCP server (`dc --mcp`, optional `mcp` dep). **Install via PyPI** (easiest):
```bash
pip install dynamitecircle
dc setup --api-key dk_your_api_key
dc self-test
dc profile
```
The package is published on PyPI as `dynamitecircle` — same code as the repo, version-locked to the deployed API.'
title: DC Member Alerts API
version: 2.6.11
servers:
- description: Production
url: https://api.dynamitecircle.com
security:
- ApiKeyAuth: []
tags:
- name: Alerts
paths:
/alerts:
get:
description: Returns the user's alerts, ordered by creation date (newest first). Maximum 50 results.
operationId: get_alerts
responses:
'200':
content:
application/json:
schema:
properties:
alerts:
items:
type: object
type: array
description: Array of the user's alerts
properties:
alertID:
type: string
description: Alert ID
name:
type: string
description: Alert name
description:
type: string
description: Alert description
notifyDaily:
type: boolean
description: Whether daily digests are enabled
notifyWeekly:
type: boolean
description: Whether weekly digests are enabled
active:
type: boolean
description: Whether the alert is currently active
embeddingModel:
type: string
description: Embedding model used for matching (null until generated)
createdAt:
type: string
description: ISO 8601 — when the alert was created
updatedAt:
type: string
description: ISO 8601 — when the alert was last updated
lastDeliveredAt:
type: string
description: ISO 8601 — when the last digest was delivered (null if never delivered)
type: object
description: Success
'401':
description: Unauthorized — missing or invalid API key
'403':
description: Forbidden — inactive membership or not eligible
'429':
description: Rate limit exceeded
summary: List your alerts
tags:
- Alerts
post:
description: Create a new alert. The system will search for matching content and deliver digests on the configured frequency. Maximum 10 active alerts per user.
operationId: post_alerts
responses:
'200':
content:
application/json:
schema:
properties:
ok:
type: boolean
description: Always `true` on success
data:
type: object
description: The created alert data
properties:
alertID:
type: string
description: The new alert ID
type: object
description: Success
'401':
description: Unauthorized — missing or invalid API key
'403':
description: Forbidden — inactive membership or not eligible
'429':
description: Rate limit exceeded
summary: Create an alert
tags:
- Alerts
requestBody:
content:
application/json:
schema:
properties:
description:
type: string
description: Alert description — what the alert should look for (max 500 chars)
notifyDaily:
type: boolean
description: Whether daily digests are enabled
notifyWeekly:
type: boolean
description: Whether weekly digests are enabled
type: object
required:
- description
- notifyDaily
- notifyWeekly
required: true
/alerts/{alertID}:
patch:
description: Update one or more fields on an existing alert. Only provide the fields you want to change.
operationId: patch_alerts__alertID
responses:
'200':
content:
application/json:
schema:
properties:
ok:
type: boolean
description: Always `true` on success
alert:
type: object
description: The updated alert
type: object
description: Success
'401':
description: Unauthorized — missing or invalid API key
'403':
description: Forbidden — inactive membership or not eligible
'429':
description: Rate limit exceeded
summary: Update an alert
tags:
- Alerts
parameters:
- description: The alert ID to update
example: abc123
in: path
name: alertID
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
properties:
name:
type: string
description: New alert name
description:
type: string
description: New alert description
notifyDaily:
type: boolean
description: Whether daily digests are enabled
notifyWeekly:
type: boolean
description: Whether weekly digests are enabled
active:
type: boolean
description: Whether the alert is active
type: object
required: true
delete:
description: 'Soft-delete an alert by setting `active: false`. The alert''s history is preserved for past digests. Use `PATCH /alerts/:alertID` with `active: true` to reactivate.'
operationId: delete_alerts__alertID
responses:
'200':
content:
application/json:
schema:
properties:
ok:
type: boolean
description: Always `true` on success
type: object
description: Success
'401':
description: Unauthorized — missing or invalid API key
'403':
description: Forbidden — inactive membership or not eligible
'429':
description: Rate limit exceeded
summary: Deactivate an alert
tags:
- Alerts
parameters:
- description: The alert ID to delete
example: abc123
in: path
name: alertID
required: true
schema:
type: string
components:
securitySchemes:
ApiKeyAuth:
bearerFormat: dk_<userID>_<random>
description: 'Your DC Member API key. Generate one from the user menu inside the DC member area (admin/tester access required). Send it as `Authorization: Bearer dk_your_api_key`.'
scheme: bearer
type: http