Build on
the record.SDK · MCP
WARN · SQL

1. 01Read without a key: curl https://cyclopslabs.dev/api/v1/launches?limit=5.
2. 02Get a key when you need higher limits or your own routes: a free key in 30 seconds, or one tied to your wallet’s tier on the account page. Send it as x-api-key.
3. 03Find the call in the API reference, send it from the console, copy it as curl.

// packages/sdk-ts · zero dependencies · Node 18+, Deno, Bun, browsers
import { Cyclops } from '@cyclops/sdk';

const cx = new Cyclops({ apiKey: process.env.CYCLOPS_API_KEY });
const { launches } = await cx.launches({ outcome: 'collapsed', limit: 20 });
const read = await cx.inspect('0x…'); // token, wallet, contract or tx hash
const stop = cx.firehose((l) => console.log(l.symbol, l.firstMinute));

# packages/sdk-py · standard library only · Python 3.9+
# pip install ./packages/sdk-py
import os
from cyclops_sdk import Cyclops

cx = Cyclops(api_key=os.environ.get("CYCLOPS_API_KEY"))
stats = cx.launch_stats()
read = cx.inspect("0x…")
for launch in cx.firehose():  # blocks; yields each new launch
    print(launch["symbol"], launch["firstMinute"])

Both SDKs live in the repository (packages/sdk-ts, packages/sdk-py) and are not on npm or PyPI yet. They return the API’s JSON unchanged and retry 429 and 503 answers after Retry-After.

{
  "mcpServers": {
    "cyclops": {
      "command": "node",
      "args": ["/path/to/cyclops/packages/mcp/src/index.mjs"],
      "env": { "CYCLOPS_API_KEY": "cyc_…" }
    }
  }
}

Tools: scan, inspect, wallet, launches, creator. Stdio, no dependencies, Node 18+. See tools for AI agents for x402 pay-per-scan.

import { CyclopsWarn } from '@cyclops/warn/react';

<CyclopsWarn address={tokenAddress} />
<CyclopsWarn address={tokenAddress} compact onResult={(s) => setNeedsConfirm(s.status === 'scanned' && s.label === 'High')} />

<script type="module">
  import { defineCyclopsWarn } from '@cyclops/warn/element';
  defineCyclopsWarn();
</script>
<cyclops-warn address="0x…"></cyclops-warn>

A pre-trade warning next to a swap button: the stored scan’s label, score and top observations, or a plain “no stored scan” or “could not be reached”. It reads the cached explorer endpoint, never starts a scan, never blocks a trade and never calls a token free of risk. Source and props: packages/warn/README.md; not on npm yet.

• DOCResearcher SQL

  Read-only SQL over the research views, for Pro and research grants.

• DOCSlack

  /cyclops in any channel, and alerts to team channels.

• DOCWebhooks

  Signed alert and launch deliveries (POST /v1/me/webhooks), HMAC-SHA256 with a five-minute window.

• DOCExplorer snippet

  Show the stored scan beside any address page.

• DOCPre-launch API

  Check a contract before it trades (partners).

• DOCAgents

  The MCP server and x402 pay-per-scan.

Zapier and n8n integrations on top of the webhooks are in the repository (packages/zapier-cyclops, packages/n8n-nodes-cyclops) and not listed in either directory yet.

• examples/launch-watch

  The latest launches with first-minute stats, then 30-day outcomes. Public reads, no key.

  node examples/launch-watch/index.mjs
• examples/outcomes-py

  Outcome shares for recent launches with the Python SDK.

  PYTHONPATH=packages/sdk-py python3 examples/outcomes-py/outcomes.py
• examples/webhook-receiver

  A receiver that checks the x-cyclops-signature HMAC before trusting an alert.

  CYCLOPS_WEBHOOK_SECRET=whsec_… node examples/webhook-receiver/server.mjs
• examples/research-sql

  A read-only SQL query over the research views, printed as a table.

  CYCLOPS_API_KEY=cyc_… node examples/research-sql/query.mjs

From a checkout of the repository. Each prints what the API returns and exits non-zero, saying why, when the API is unreachable.

Every public API change, from the repository history. Subscribe: Atom feed. Paths under /v1 keep their meaning; fields are added, never removed or retyped.