nvoke Tools API

The Tools API from nvoke — 3 operation(s) for tools.

GitHub OpenAPI

Operations 3

POST /v1/tools/verify-email Check one email address, free #
POST /v1/tools/extract-emails Read one website for emails, free #
POST /v1/tools/email-auth Check SPF, DMARC, DKIM and MX, free #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nvoke-run:nvoke-run-tools-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nvoke-run-tools-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: nvoke Tools API
  version: 0.1.0
  description: 'Find companies, read their websites and get email addresses checked with the mail server. Everything the desktop app does. Send `Authorization: Bearer `.'
servers:
- url: https://api.nvoke.run
tags:
- name: Tools
paths:
  /v1/tools/verify-email:
    post:
      operationId: toolVerifyEmail
      summary: Check one email address, free
      description: 'The free email verifier on nvoke.run/tools. Syntax, disposable domains, MX records and, while the small free probe budget lasts, the mail server itself (`depth: mailbox`). Past that budget it answers from syntax and DNS (`depth: domain`). Rate limited per IP and per day. For volume, use a search of kind `domains` with an API key.'
      tags:
      - Tools
      security: []
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  minLength: 3
                  maxLength: 320
                turnstileToken:
                  description: Cloudflare Turnstile token, when the server asks for one.
                  type: string
                  maxLength: 2048
              required:
              - email
            example:
              email: hello@example.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  email:
                    type: string
                  verification:
                    type: string
                    enum:
                    - valid
                    - invalid
                    - risky
                    - catch_all
                    - unknown
                  reason:
                    type: string
                  mxHost:
                    type:
                    - string
                    - 'null'
                  depth:
                    type: string
                    enum:
                    - mailbox
                    - domain
                required:
                - email
                - verification
                - reason
                - mxHost
                - depth
                additionalProperties: false
        4XX:
          description: '`invalid_request`: The body or query failed validation. `details` lists the problems.


            `rate_limited`: Too many requests of this kind from this account or client. Try again later.


            `captcha_failed`: The Turnstile token was missing or did not pass. Solve the challenge again.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/tools/extract-emails:
    post:
      operationId: toolExtractEmails
      summary: Read one website for emails, free
      description: The free website email extractor on nvoke.run/tools. Reads the homepage and likely contact pages of one domain (robots.txt honored, opt-outs respected) and returns its generic role addresses. Addresses of people are counted in `hiddenPersonal` and shown only in a search. Rate limited per IP and per day.
      tags:
      - Tools
      security: []
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                domain:
                  type: string
                  minLength: 3
                  maxLength: 253
                turnstileToken:
                  description: Cloudflare Turnstile token, when the server asks for one.
                  type: string
                  maxLength: 2048
              required:
              - domain
            example:
              domain: example.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  status:
                    type: string
                    enum:
                    - done
                    - blocked
                    - refused
                    - js_only
                    - failed
                    - opted_out
                  emails:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                        sourceUrl:
                          type:
                          - string
                          - 'null'
                      required:
                      - address
                      - sourceUrl
                      additionalProperties: false
                  hiddenPersonal:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  cached:
                    type: boolean
                required:
                - domain
                - status
                - emails
                - hiddenPersonal
                - cached
                additionalProperties: false
        4XX:
          description: '`invalid_request`: The body or query failed validation. `details` lists the problems.


            `rate_limited`: Too many requests of this kind from this account or client. Try again later.


            `captcha_failed`: The Turnstile token was missing or did not pass. Solve the challenge again.


            `busy`: Too many free tool checks are running or today’s free allowance is used up. Try again later, or sign up.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/tools/email-auth:
    post:
      operationId: toolEmailAuth
      summary: Check SPF, DMARC, DKIM and MX, free
      description: 'The free SPF and DMARC checker on nvoke.run/tools. DNS only: MX hosts, the SPF record with its lookup count, the DMARC policy and DKIM keys under common selectors, each graded pass, warn or fail. Rate limited per IP.'
      tags:
      - Tools
      security: []
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                domain:
                  type: string
                  minLength: 3
                  maxLength: 253
              required:
              - domain
            example:
              domain: example.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  mx:
                    type: object
                    properties:
                      grade:
                        type: string
                        enum:
                        - pass
                        - warn
                        - fail
                      hosts:
                        type: array
                        items:
                          type: string
                      notes:
                        type: array
                        items:
                          type: string
                    required:
                    - grade
                    - hosts
                    - notes
                    additionalProperties: false
                  spf:
                    type: object
                    properties:
                      grade:
                        type: string
                        enum:
                        - pass
                        - warn
                        - fail
                      record:
                        type:
                        - string
                        - 'null'
                      all:
                        type:
                        - string
                        - 'null'
                      lookups:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      notes:
                        type: array
                        items:
                          type: string
                    required:
                    - grade
                    - record
                    - all
                    - lookups
                    - notes
                    additionalProperties: false
                  dmarc:
                    type: object
                    properties:
                      grade:
                        type: string
                        enum:
                        - pass
                        - warn
                        - fail
                      record:
                        type:
                        - string
                        - 'null'
                      policy:
                        anyOf:
                        - type: string
                          enum:
                          - none
                          - quarantine
                          - reject
                        - type: 'null'
                      notes:
                        type: array
                        items:
                          type: string
                    required:
                    - grade
                    - record
                    - policy
                    - notes
                    additionalProperties: false
                  dkim:
                    type: object
                    properties:
                      grade:
                        type: string
                        enum:
                        - pass
                        - warn
                        - fail
                      selectors:
                        type: array
                        items:
                          type: string
                      notes:
                        type: array
                        items:
                          type: string
                    required:
                    - grade
                    - selectors
                    - notes
                    additionalProperties: false
                required:
                - domain
                - mx
                - spf
                - dmarc
                - dkim
                additionalProperties: false
        4XX:
          description: '`invalid_request`: The body or query failed validation. `details` lists the problems.


            `rate_limited`: Too many requests of this kind from this account or client. Try again later.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          enum:
          - unauthorized
          - claim_required
          - invalid_request
          - not_found
          - quota_exceeded
          - source_unavailable
          - not_cancelable
          - search_running
          - kind_mismatch
          - ongoing_not_supported
          - search_canceled
          - not_claimed
          - api_key_limit
          - account_exists
          - email_not_accepted
          - rate_limited
          - captcha_failed
          - busy
          - site_unreadable
          - ai_unavailable
          - ai_key_rejected
          - ai_model_unknown
          - search_key_rejected
          - signup_unavailable
          - too_many_drops
          - too_many_webhooks
          - webhook_url_not_allowed
          - database_unavailable
        details: {}
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: An API key (nvk_sk_...) or an OAuth access token from nvoke’s Clerk.