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/superclean-company-names).

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

# Clean a company name
curl "https://superlativetech--superclean-company-names.apify.actor?token=TOKEN&input=ACME+CORPORATION+INC"
# {"id":1,"input":"ACME CORPORATION INC","output":"Acme","confidence":0.95}

# Validate an email
curl "https://superlativetech--superclean-emails.apify.actor?token=TOKEN&[email protected]"
# {"id":1,"input":"[email protected]","output":"[email protected]","isValid":true,"suggestedFix":"gmial.com → gmail.com"}

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

# Check domain health
curl "https://superlativetech--supernet-domain-health.apify.actor?token=TOKEN&domain=example.com"
# {"domain":"example.com","score":85,"band":"Good","summary":"..."}

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

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 });

// Clean company names
const run = await client.actor('superlativetech/superclean-company-names').call({
  items: ['ACME CORPORATION, INC.', 'GOOGLE LLC', 'walmart inc'],
  style: 'casual'
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
// [{ id: 1, input: 'ACME CORPORATION, INC.', output: 'Acme', confidence: 0.95 }, ...]

Python

from apify_client import ApifyClient
import os

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

# Validate emails
run = client.actor('superlativetech/superclean-emails').call(run_input={
    'items': ['[email protected]', '[email protected]', '[email protected]']
})
items = client.dataset(run['defaultDatasetId']).list_items().items
# Each item: { id, input, output, isValid, domain, hasMx, isDisposable, ... }

Input Formats

All Superclean actors accept flexible input:

// String array
{ "items": ["value1", "value2"] }

// Single item shorthand
{ "item": "single value" }

// Object format (for integrations)
{ "items": [{ "input": "value1" }] }

Supernet actors use domains/domain instead of items/item. ICP Scorer uses leads/lead (JSON objects).

Actor Catalog

All 14 actors with their IDs, input/output formats, and pricing.

Superclean (Data Cleaning)

Supernet (Network Intelligence)

Superlead (Lead Intelligence)

Utilities

Pipeline Examples

Actors compose into lead enrichment pipelines. Scrape data from any source, then chain Superlative actors to clean, enrich, and score.

Lead Cleaning Pipeline

// 1. Clean company names
const companies = await client.actor('superlativetech/superclean-company-names')
  .call({ items: rawCompanyNames, style: 'casual' });

// 2. Validate emails
const emails = await client.actor('superlativetech/superclean-emails')
  .call({ items: rawEmails });

// 3. Score against ICP
const scores = await client.actor('superlativetech/superlead-icp-scorer')
  .call({ leads: enrichedLeads, icp: 'B2B SaaS, 50-500 employees, VP+ titles' });

Domain Audit Pipeline

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

const health = await client.actor('superlativetech/supernet-domain-health')
  .call({ domains: prospectDomains, mode: 'receiving', depth: 'advanced' });

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

Pricing

All actors use pay-per-event pricing. No subscriptions. Volume discounts apply automatically.

Tiers apply per run. Process 10,000 emails in a single run and every item is charged at the Gold rate automatically.