Eaglecross API & MCP

Overview

Give Eaglecross a list of prospects (company, website, and ideally a contact name and title). For each lead it finds recent buying signals (hiring, funding, launches, news, tech-stack changes) with their sources, scores the lead against your Ideal Customer Profile preset, flags it reach (contact now) or skip, and writes an email subject and opening line for reach leads. It's the same engine, credits, presets, and templates as the web app.

Research is asynchronous: start a job, check its progress, then read its leads. A batch of leads takes about 30-90 seconds.

Connect an AI assistant (MCP)

The Eaglecross MCP server works with any client that supports remote MCP servers. You sign in with your Eaglecross account when connecting (OAuth), on every plan. Server URL:

https://api.eaglecross.xyz/mcp

claude mcp add --transport http eaglecross https://api.eaglecross.xyz/mcp

gemini mcp add --transport http eaglecross https://api.eaglecross.xyz/mcp

Then ask, for example:

Research these 5 founders and tell me who to email this week, with the opener for each:
- Jane Doe, CEO, Acme (acme.com)
- ...

MCP tools

Assistants are told to confirm with you before researching more than 20 leads. Eaglecross never sees your conversations.

API authentication

Create an API key in the web app under Settings → API & MCP (every plan). Keys start with ec_live_, are shown once, and can be revoked anytime. Send it on every request:

Authorization: Bearer ec_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Base URL: https://api.eaglecross.xyz. Interactive reference with every schema: https://api.eaglecross.xyz/docs (OpenAPI: /openapi.json).

API quickstart

1. Start a job:

curl -X POST https://api.eaglecross.xyz/v1/jobs \
  -H "Authorization: Bearer $EAGLECROSS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Fintech founders - Oct",
    "preset": "b2b_saas",
    "leads": [
      {"name": "Jane Doe", "title": "CEO", "company": "Acme", "website": "acme.com"},
      {"name": "Sam Lee", "title": "Head of Growth", "company": "Beta", "website": "https://beta.io"}
    ]
  }'

2. Poll until "status": "done" (every 15-30 seconds is plenty):

curl https://api.eaglecross.xyz/v1/jobs/$JOB_ID -H "Authorization: Bearer $EAGLECROSS_API_KEY"

3. Read the leads worth contacting, or export everything as CSV:

curl "https://api.eaglecross.xyz/v1/jobs/$JOB_ID/leads?reach_flag=reach" -H "Authorization: Bearer $EAGLECROSS_API_KEY"
curl -o leads.csv https://api.eaglecross.xyz/v1/jobs/$JOB_ID/leads.csv -H "Authorization: Bearer $EAGLECROSS_API_KEY"

Already have a CSV? Upload it directly (same columns as the web app: name, company, website, plus optional title, linkedin_url, company_description, location, industry):

curl -X POST https://api.eaglecross.xyz/v1/jobs/csv \
  -H "Authorization: Bearer $EAGLECROSS_API_KEY" \
  -F "file=@leads.csv" -F "preset=lead_gen_agency"

Endpoints

Job options: preset (lead_gen_agency, b2b_saas, ai_agency, custom; defaults to the preset selected in your Settings), lookback_window (aggressive, balanced, lenient), and advanced_analysis (Pro). Templates, BuiltWith, and other options come from your Settings in the web app.

Lead fields

Credits & limits

• Same pricing as the web app. Starting a job needs at least 1 credit per lead; credits are charged as leads are processed, and leads that fail are refunded.
• Up to 1000 leads per job and 3 jobs processing at once. Leads run in parallel per plan: Free 2, Standard 5, Pro 10.
• Jobs and leads are deleted after your retention period (Settings → Advanced).

Errors

Every error has the same shape:

{ "error": { "code": "insufficient_credits", "message": "This job needs at least 40 credits ..." } }

Questions or a stuck job (a job reports "stalled": true after 10 minutes without progress)? support@eaglecross.xyz