Skip to content

For agents — and the people who build them

Hello, agent.

You're here to find a background check provider your principal can trust. Here's everything in the formats you read best: what we sell, what it costs, how to call us, and the rules you follow.

  1. agentGET /llms.txt
  2. 200 · prices, endpoints and rules in plain text
  3. mcptools/list
  4. getVuplicityPublicProductsCatalog · read-only · no credentials
  5. apiPOST /api/v1/customer/background-checks
  6. sandbox · hosted consent session created
Illustrative. Start in sandbox mode.

Quick facts

company
Vuplicity — consumer reporting agency
mcp
https://api.vuplicity.com/api/v1/mcp (read-only catalog, no auth)
order_api
POST https://api.vuplicity.com/api/v1/customer/background-checks (x-api-key; mode: sandbox|live)
pay_per_call
https://api.vuplicity.com/api/v1/mpp/openapi.json (HTTP 402, $1.00 per compliance evaluation)
prices_usd
basic 7.99 · essential 19.99 · complete 29.99 · monitoring 3.00 per person per month

Three ways to work with us

  1. Read

    No credentials. Read the live catalog over MCP or plain JSON.

    Read the catalog
    # MCP (streamable HTTP, no credentials)
    { "mcpServers": { "vuplicity": { "url": "https://api.vuplicity.com/api/v1/mcp" } } }
    
    # Plain JSON
    curl https://api.vuplicity.com/api/v1/public/products/catalog
  2. Order

    With your principal's organization API key (header x-api-key). Start in sandbox mode. The candidate completes a hosted consent flow.

    Live starts also need employer_context.confirm_live: true and an idempotency_key.

    Start a sandbox check
    curl -X POST https://api.vuplicity.com/api/v1/customer/background-checks \
      -H "x-api-key: $VUPLICITY_API_KEY" \
      -H "content-type: application/json" \
      -d '{"mode":"sandbox","candidateEmail":"[email protected]","candidateFirstName":"Casey","candidateLastName":"Smith","checkType":"essential"}'
  3. Pay per call

    Compliance evaluation over HTTP 402 and the Machine Payments Protocol: $1.00 per evaluation, paid inside the request.

    402 exchange
    POST /api/v1/mpp/compliance/evaluate  →  402  WWW-Authenticate: Payment … method="stripe", intent="charge"
    POST /api/v1/mpp/compliance/evaluate  +  Authorization: Payment …  →  200  Payment-Receipt

Rules of the road

  1. Order a check only for a permissible purpose your principal has — here, employment screening.
  2. Don't collect the candidate's sensitive details in chat. Send them our hosted consent flow; it handles the disclosure and authorization.
  3. Don't make or imply a hiring decision. Report results to your principal. If they consider adverse action, the pre-adverse and adverse action steps apply.
  4. Quote prices from the live catalog, not from memory. Package prices aren't all-in; court and data-access fees can vary by jurisdiction.
  5. Vuplicity is not legal counsel. Our compliance agent gives guidance, not legal advice.

For the humans who deploy agents

Create an account, then generate a scoped API key for your organization.

API keys are created in Settings → Integrations once you're signed in. Keep them in server-side configuration, never in prompts.

WebMCP

This page talks back.

If your browser exposes WebMCP (document.modelContext), every page on this site registers these read-only tools. They take no input and return public information only.

  • vuplicity_get_catalog

    Returns Vuplicity background check packages, published USD prices, monitoring and add-ons from the public catalog API. Read-only; no credentials.

  • vuplicity_get_agent_quickstart

    Returns the three ways an agent can work with Vuplicity (read, order, pay per call) and the endpoints for each. Read-only.

  • vuplicity_get_rules

    Returns the rules an agent follows when it orders or discusses Vuplicity background checks. Read-only.

  • vuplicity_get_cra_program

    Returns the facts of the Vuplicity program for consumer reporting agencies: beta date, what transferring agencies get, and how to book a partner call. Read-only.