> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to CoinMarketCal

The CoinMarketCal connector lets your AI agent act in each user's CoinMarketCal account. Each user connects their own CoinMarketCal API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 8 tools.

**Authentication:** API Key
**Categories:** Accounting & Finance, Calendar
**Tools:** 8: 8 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=COINMARKETCAL)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the CoinMarketCal connection

   In **AgentKit > Connections**, create a CoinMarketCal connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'coinmarketcal'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize CoinMarketCal:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'coinmarketcal_categories_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "coinmarketcal"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize CoinMarketCal:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="coinmarketcal_categories_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their CoinMarketCal credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'coinmarketcal_categories_list',
  toolInput: {},
  connector: 'coinmarketcal',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="coinmarketcal_categories_list",
    tool_input={},
    connection_name="coinmarketcal",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `coinmarketcal_categories_list`

List Event Categories · Read-only

List every CoinMarketCal event category with its count of upcoming events.
Returns the categories with id, name and event counts for your plan's window. Not paginated.
Use this to get category IDs for coinmarketcal_events_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `coinmarketcal_coin_get`

Get Coin · Read-only

Get one coin from CoinMarketCal by its slug.
Returns the coin with slug, symbol, name, rank, tracking status and event counts. Unknown slugs return 404.
Use this to check a coin before filtering events by it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `slug` (`string`, required): Lowercase coin slug, from coinmarketcal_coins_list. Example: bitcoin.

Example input: `{"slug":"<slug>"}`

### `coinmarketcal_coins_list`

List Coins · Read-only

List the coins in the CoinMarketCal database, ordered by rank, optionally searched by name or symbol.
Returns data (coins with slug, symbol, name, rank and event counts) and meta.cursor for paging.
Use this to find a coin slug for coinmarketcal_events_list or coinmarketcal_coin_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Opaque cursor from the previous response's meta.cursor, to get the next page. A null meta.cursor means there are no more pages. Example: eyJvZmZzZXQiOjUwfQ.
- `limit` (`integer`, optional): Page size, from 1 to 200. Example: 50.
- `q` (`string`, optional): Case-insensitive text to match in coin name or symbol. Example: sol.
- `tracked` (`boolean`, optional): true for coins CoinMarketCal actively covers, false for coins outside coverage; omit for both. Example: true.

Example input: `{}`

### `coinmarketcal_event_cancellations_list`

List Removed Events · Read-only

List CoinMarketCal events that were permanently removed, ordered by removal time.
Returns data (records with the event ID and cancelledAt) and meta.cursor for paging.
Use this to drop removed events from a local copy of the calendar.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Opaque cursor from the previous response's meta.cursor, to get the next page. A null meta.cursor means there are no more pages. Example: eyJvZmZzZXQiOjUwfQ.
- `limit` (`integer`, optional): Page size, from 1 to 100. Example: 50.
- `since` (`string`, optional): Earliest removal time, as an RFC 3339 timestamp or YYYY-MM-DD date. Defaults to 90 days ago. Example: 2026-10-01.

Example input: `{}`

### `coinmarketcal_event_get`

Get Crypto Event · Read-only

Get the full details of one CoinMarketCal event by its ID.
Returns the event with title, description, date, dateType, isEstimated, categories, coins and plan-dependent fields such as impact, sources and proof. Removed events return 410 and unknown ones 404.
Use this after coinmarketcal_events_list to read one event.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Event ID exactly as returned by coinmarketcal_events_list. Example: evt_01JQ8Z4S2M9Y7K3P6D1A.

Example input: `{"id":"<id>"}`

### `coinmarketcal_events_list`

List Crypto Events · Read-only

List upcoming and past cryptocurrency events (releases, listings, upgrades, conferences and more) from the CoinMarketCal calendar, filtered by coin, category, date range or keyword.
Returns data (events with id, slug, title, description, date, dateType, isEstimated, categories, coins and plan-dependent fields such as impact and sources) and meta.cursor for paging.
Use this to find events. Use coinmarketcal_event_get for one event's full details. The date window and some filters depend on your plan.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `categories` (`string`, optional): Comma-separated category IDs from coinmarketcal_categories_list. Standard plan and higher; the Free plan gets 403. Example: release,exchange.
- `coins` (`string`, optional): Comma-separated coin slugs (preferred) or tickers. Get slugs from coinmarketcal_coins_list. Example: bitcoin,ethereum.
- `cursor` (`string`, optional): Opaque cursor from the previous response's meta.cursor, to get the next page. A null meta.cursor means there are no more pages. Example: eyJvZmZzZXQiOjUwfQ.
- `from` (`string`, optional): Inclusive earliest event date (ISO 8601). Defaults to today; how far back you can go depends on your plan. Example: 2026-11-16.
- `impact_min` (`number`, optional): Minimum impact score, 0.0 to 10.0. Elite plan and higher. Example: 7.5.
- `keyword` (`string`, optional): Case-insensitive text to search event titles and descriptions for. Example: mainnet.
- `limit` (`integer`, optional): Page size, from 1 to 100. Example: 50.
- `sort_by` (`string`, optional): Sort order: date_asc (default, soonest first), date_desc, created_desc, created_desc_and_updated_desc or impact_desc (Elite plan and higher). Example: date_asc. One of: `date_asc`, `date_desc`, `created_desc`, `created_desc_and_updated_desc`, `impact_desc`.
- `to` (`string`, optional): Inclusive latest event date (ISO 8601). Defaults to today plus your plan's window (7 days on Free, 90 on Standard). Example: 2026-12-31.

Example input: `{}`

### `coinmarketcal_events_snapshot_get`

Get Events Catalog Snapshot · Read-only

Get the current daily snapshot of the complete CoinMarketCal events catalog.
Returns generatedAt, expiresAt, format (csv.gz), rowCount and a private downloadUrl valid for 15 minutes.
Use this to bulk-load the whole catalog. Use coinmarketcal_events_list for filtered queries.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `coinmarketcal_usage_get`

Get API Usage · Read-only

Get this month's request counters for your CoinMarketCal API key.
Returns tier, periodYm, requestCount, monthlyQuota, remaining and quotaResetAt.
Use this to check the remaining quota before many requests.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
