MCP server · OAuth · Test mode

Credit lookups for AI agents.

Connect Claude, ChatGPT, Cursor or your own agent to our MCP server. It signs in with OAuth, spends only within the limit you set, and can run in test mode with sample people.

The server’s address

Paste it into any assistant that supports MCP.

https://phonenumbercreditscore.com/mcp

How to add it

A minute, start to finish.

Chat assistants: Claude, ChatGPT and others

  1. In the assistant’s settings, find Connectors, Apps or Integrations and add a custom one.
  2. Paste the server’s address. If it asks how to sign in, pick OAuth.
  3. Sign in to your account and choose what it can do: test or live, a monthly spending limit, and whether a person approves each paid lookup.

Coding tools and agents

Add this to the tool’s MCP settings (an mcp.json file, for example). It opens this site to sign in the first time.

{
    "mcpServers": {
        "phone-number-credit-score": {
            "url": "https://phonenumbercreditscore.com/mcp"
        }
    }
}

Tools that can’t sign in

Send an API key instead. Prefer OAuth when you can: each connection gets its own limits and can be cut off alone.

{
    "mcpServers": {
        "phone-number-credit-score": {
            "url": "https://phonenumbercreditscore.com/mcp",
            "headers": {
                "Authorization": "Bearer ${PNCS_KEY}"
            }
        }
    }
}

You stay in control

Built for agents that spend money.

OAuth sign-in

8 separate scopes. Tokens expire, rotate and stop the moment you disconnect.

Spending limit

A monthly cap for each connection, separate from the account’s.

Approvals

Optionally, a person approves every paid lookup before it runs.

Test mode

Sample people for any number, never charged. Test numbers act out every outcome.

The tools

14 tools, one connection.

An agent can pre-qualify a caller, sum up their credit profile, flag fraud risk and draft the next step. Tools that cost money say so, and no match is free.

  • lookup_phoneName, address, phone details, FICO® Score 4 and credit profile for a U.S. number
  • unlock_tradelinesEvery account and payment on a past lookup
  • caller_name_lookupThe caller ID name for a number
  • carrier_lookupLine type and carrier for a number
  • address_checkAn address checked against official postal data
  • get_lookupA past lookup, exactly as it was
  • list_lookupsRecent lookups
  • get_balanceThe prepaid balance and prices
  • add_fundsAdd to the balance, only if you allow it
  • get_usageThis month’s lookups and spending
  • get_accountThe account and this connection’s limits
  • list_requestsRecent requests, for troubleshooting
  • check_approvalWhether a person approved a paid lookup
  • sandbox_numbersTest numbers that act out each outcome

More ways in

Every integration we offer today.

REST API

One request, clean JSON

A phone number in; name, address and FICO® Score 4 out. $7.50 per match.

About the API
OAuth apps

Your own product

Register an app and let your customers or teammates connect their accounts, with scopes they choose.

Developer docs
Beta

Zapier

Look people up from forms, CRMs and spreadsheets, with instant triggers. No code.

About Zapier

Questions

Which assistants work with it?

Any assistant, agent or coding tool that can add a remote MCP server: Claude, ChatGPT, Cursor, VS Code and others. Some assistants offer custom connectors only on certain plans; check the assistant’s own settings.

What does it cost?

It’s included with the API plan ($49 a month or $149 a year). Lookups cost the same as through the API: $7.50 for each one that finds a match, and no match is free. Test connections are free.

Can an assistant overspend?

No. Each connection has its own monthly spending limit, and you can require a person to approve every paid lookup. Disconnect it any time and its access stops at once.

Is it safe to give an assistant credit data?

The assistant sees only what you allow: you pick its access when you sign in, test or live. Every lookup is logged with its purpose on your account.

Agents follow the same rules as the API: a permissible purpose under the Fair Credit Reporting Act on every lookup, such as the person’s written consent. The rules

Ready?

Give your agent a credit check.

The MCP server comes with the API plan. Test connections are free.