Get Started
API & MCP

Get calling priority through API or MCP.

Send a first name, last name and US phone number. Get back a grade, next action, reason and supporting signals.

Read the docsGet API key
One account for API and MCP250 free creditsUS contacts only
YOU SEND
First nameTavin
Last nameOrrell
US phone number+1 609 184 3726
YOU GET BACK
GradeA1A2A3X
ActionCall First · Call Next · LinkedIn + Email · Remove
ReasonWhy the contact got its grade, in plain English
SignalsValid number, line type, activity, name match, litigation risk
TWO WAYS IN

Same result, wherever you work.

Use the REST API from your own code, or connect through MCP. Both use the same account and credits.

REST API

For backend and product workflows. Call it directly from your own code.

  • Send JSON, get JSON back
  • Best for direct product integrations

MCP

For AI agents and assistant workflows. Connect once and let the agent use the tool.

  • Same account and credits as the API
  • Best for Claude and other agentic workflows
Both return the same result:A1A2A3Xwith a reason and signals.
QUICKSTART

Get your first result in three steps.

Step 1

Get your API key

Sign up free, then create an API key. You start with 250 credits.

API key YOUR_API_KEY
Step 2

Send a contact

Post a first name, last name and phone number. One contact uses one credit.

curl -X POST "https://app.willthispersonanswer.com/api/v1/analyze" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contacts":[{"first_name":"John","last_name":"Smith","phone":"+12125550136"}]}'
Step 3

Act on the grade

Route the contact by its grade: dial A1s first, then A2s, send A3s to LinkedIn and email, and drop X. Every grade comes with the evidence it was decided from, so you can check it rather than take it on trust.

A1
Call First
A2
Call Next
A3
LinkedIn + Email
X
Remove
EXAMPLE

One request. One clear answer.

ENDPOINTPOST /api/v1/analyze
AUTHBearer token
INPUTfirst_name, last_name, phone
POST /api/v1/analyze
REQUEST
{
  "contacts": [
    {
      "first_name": "John",
      "last_name": "Smith",
      "phone": "+12125550136"
    }
  ]
}
RESPONSE
{
  "results": [
    {
      "phone": "+12125550136",
      "status": "ok",
      "grade": "A1",
      "action": "call_first",
      "reason": "The line shows strong activity signals and the supplied name matches the number.",
      "signals": {
        "valid": true,
        "line_type": "mobile",
        "activity": "strong",
        "name_match": true,
        "litigation_risk": false
      }
    }
  ],
  "summary": {
    "analyzed": 1,
    "grades": { "A1": 1, "A2": 0, "A3": 0, "X": 0 },
    "undetermined": 0
  }
}
RESPONSE REFERENCE

Every field,
explained.

The grade tells you what to do. The reason tells you why. Signals come after.

FIELDTYPEDESCRIPTION
gradestring | nullA1, A2, A3 or X. Null where no analysis completed.
actionstring | nullcall_first, call_next, linkedin_email or remove. Derived from the grade.
reasonstringOne deterministic sentence. Always present, including when there is no grade.
signals.validboolean | nullWhether the line is real. Null where nobody could establish it.
signals.line_typestringmobile, landline, voip, other or unknown.
signals.activitystringstrong, weak or silent.
signals.name_matchboolean | nullWhether the name belongs to the number. Null where there is no opinion.
signals.litigation_riskboolean | nullTrue found, false screened and clean, null no answer. Null is never clean.
phonestringThe contact, canonicalised to E.164.
statusstringok, invalid_request, unsupported_market, incomplete or provider_unavailable.
summary.analyzednumberHow many contacts came back.
summary.gradesobjectCounts per grade: A1, A2, A3 and X.
summary.undeterminednumberContacts that produced no grade, and so were not charged for.
MCP

Ask your agent who to call first.

Connect Will This Person Answer to any MCP client and prioritise contacts in plain English.

  1. 1Add the WTPA server to your MCP client.
  2. 2Sign in with your WTPA account.
  3. 3Ask it to prioritise the contacts you plan to call.
https://mcp.willthispersonanswer.com
Prioritise this outbound list and tell me who to call first.
analyze_contacts
Here’s who to call first, in order:
A1Tavin OrrellCall First. Strong activity, name matches.
A2Mira QuennellCall Next. Valid mobile, moderate activity.
A3Joss HavrenkoLinkedIn + Email. Lower calling priority.
XElsie BrannochRemove. Flagged for litigation risk.
USAGE

Simple, credit-based pricing.

1 = 1
One credit analyses one contact.
No expiry
Credits never expire.
One balance
API and MCP share the same credits.
US only
US contacts are supported.
See pricing

Get your API key.

Start with 250 free credits.

Get API key
No card requiredUS contacts only