Use Superlative with AI Agents

MCP Server

All Superlative actors are available as tools via the Apify MCP Server. This lets AI agents (Claude Code, Cursor, Windsurf, and others) discover and call actors automatically.

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote@latest", "https://mcp.apify.com/sse"],
      "env": { "APIFY_TOKEN": "YOUR_API_TOKEN" }
    }
  }
}

Cursor / Windsurf

Add a new MCP server in your IDE settings with the SSE endpoint:

URL: https://mcp.apify.com/sse
Token: YOUR_APIFY_TOKEN

Once connected, agents can search the Apify Store, read actor READMEs, and call actors directly as tools. All Superlative actors are discoverable by name (e.g. superlativetech/dns-lookup).

Standby API (Instant, Single-Item)

Every actor has a warm HTTP endpoint for sub-second responses. No cold starts. Ideal for real-time agent tool calls, Clay enrichment steps, and workflow automations.

URL Pattern

https://superlativetech--{actor-name}.apify.actor?token=TOKEN&input=VALUE

Examples

# Look up DNS records
curl "https://superlativetech--dns-lookup.apify.actor?token=TOKEN&domain=example.com&type=MX,TXT"
# {"domain":"example.com","dnsRecords":[{"type":"MX","priority":10,"exchange":"..."}]}

# WHOIS lookup
curl "https://superlativetech--whois-lookup.apify.actor?token=TOKEN&domain=example.com"
# {"domain":"example.com","registrar":"...","createdDate":"...","expiresDate":"..."}

# Make an HTTP request (POST only; a GET returns the landing page)
curl -X POST "https://superlativetech--http-api.apify.actor?token=TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"https://api.example.com/data","method":"GET"}'
# {"status":200,"statusText":"OK","response":{...}}

Pass an Authorization: Bearer TOKEN header instead of the token query parameter for cleaner URLs.

Standby URLs

Batch API (Multiple Items)

For processing hundreds or thousands of items, use the Apify Client to run actors in batch mode. Results are saved to a dataset and can be downloaded as JSON, CSV, or Excel.

Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

// Look up DNS records for many domains
const run = await client.actor('superlativetech/dns-lookup').call({
  domains: ['example.com', 'github.com', 'apify.com'],
  dnsRecordTypes: ['A', 'MX']
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
// [{ domain: 'example.com', dnsRecords: [{ type: 'A', address: '...' }, ...] }, ...]

Python

from apify_client import ApifyClient
import os

client = ApifyClient(token=os.environ['APIFY_TOKEN'])

# Pull WHOIS registration data
run = client.actor('superlativetech/whois-lookup').call(run_input={
    'domains': ['example.com', 'github.com']
})
items = client.dataset(run['defaultDatasetId']).list_items().items
# Each item: { domain, registrar, createdDate, expiresDate, nameServers, ... }

Input Formats

DNS Lookup and WHOIS Lookup accept a list of domains or a single-domain shorthand:

// Domain array
{ "domains": ["example.com", "github.com"] }

// Single domain shorthand
{ "domain": "example.com" }

HTTP API takes a single request per run, keyed on endpoint:

{ "endpoint": "https://api.example.com/data", "method": "GET" }

Actor Catalog

All 3 actors with their IDs and input/output formats.

Pipeline Examples

The actors compose into domain intelligence workflows. Extract domains from any source, then chain lookups.

Domain Audit Pipeline

// Domain intelligence for a prospect list
const dns = await client.actor('superlativetech/dns-lookup')
  .call({ domains: prospectDomains });

const whois = await client.actor('superlativetech/whois-lookup')
  .call({ domains: prospectDomains });

Enrich via any REST API

// Push results anywhere without writing glue code
await client.actor('superlativetech/http-api').call({
  endpoint: 'https://your-crm.example.com/enrich',
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(dnsResults)
});

Pricing

All actors are free to use — no per-result charges and no subscriptions. You pay only for the Apify platform compute your runs consume, which is typically negligible.

None of the three actors call AI models, so there are no token costs to pass on.