Developers · MCP

ValidReach MCP server

Let an MCP client check email addresses with your ValidReach account. One HTTP endpoint, three tools, and the same credits and rate limits as the API.

Read the MCP guide

How it works

What you get

  1. 1. Point your client at the endpoint

    Add https://validreach.dev/api/mcp as a remote MCP server in a client that supports it. Exact menus differ by client, so follow its documentation.

  2. 2. Authenticate with a key or OAuth

    Send an API key in an Authorization: Bearer header, or let a client that supports OAuth 2.1 register itself and request consent. You can withdraw OAuth access in Settings → Connected apps.

  3. 3. Use three tools

    verify_email checks one address, check_disposable checks a domain for free, and get_credits returns your balance.

Try it

A first call

curl -s https://validreach.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Limits

What to know first

  • Each definite verification result spends one credit; unknown results are not billed.
  • The server is stateless and returns plain JSON. It checks one address per call; use the file upload for lists.
  • OAuth clients register themselves (public clients with PKCE) and ask for consent with prompt=consent.
  • It is documented here and in the docs only. It is not listed in any third-party MCP directory.