Connect your AI agent

Your AI agent can read the catalog and order background checks today, through Vuplicity’s live MCP server and REST API. Everything on this page is fulfilled by Vuplicity, a consumer reporting agency.

  1. Read the catalog

    Fulfilled by Vuplicity

    No credentials needed. Point any MCP client at the MCP server, or fetch the catalog as plain JSON.

    The catalog is read-only. Its prices and availability take precedence over saved copies. MCP (Model Context Protocol) is a common way for an AI agent to discover and call tools.

    MCP client config
    {
      "mcpServers": {
        "vuplicity": { "url": "https://api.vuplicity.com/api/v1/mcp" }
      }
    }

    Plain JSON
    curl https://api.vuplicity.com/api/v1/public/products/catalog

  2. Get an API key

    Fulfilled by Vuplicity

    Create a Vuplicity account, then generate a scoped API key for your organization in Settings, under Integrations. Keep keys in server-side configuration, never in prompts.

    New organization accounts start in sandbox mode and move to live access after production approval.

  3. Order a check

    Fulfilled by Vuplicity

    Send the order with your organization’s API key in the x-api-key header. Start in sandbox mode. The candidate completes a hosted consent flow, so their sensitive details never pass through your AI agent’s chat.

    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": "casey@example.com",
        "candidateFirstName": "Casey",
        "candidateLastName": "Smith",
        "checkType": "essential"
      }'

  4. Go deeper in the docs

    Fulfilled by Vuplicity

    Vuplicity’s developer docs cover the quickstart, hosted screening sessions, webhooks, sandbox scenarios and the full API reference.

Rules your AI agent follows

Vuplicity publishes these rules for AI agents that order its checks.

  • Order a check only when the employer has a permissible purpose, such as employment screening.
  • Don’t collect the candidate’s sensitive details in chat. Send the hosted consent link instead. It handles the disclosure and authorization.
  • Don’t make or imply a hiring decision. Report results to the employer. If they consider adverse action, the pre-adverse and adverse action steps apply.
  • Quote prices from the live catalog, not from memory. Package prices aren’t all-in. Court and data-access fees can vary by jurisdiction.
  • Treat guidance as guidance, not legal advice. Vuplicity is not legal counsel.

Endpoints and files

Everything in this list is fulfilled by Vuplicity. Yemez’s own summary for AI agents is at /llms.txt.

Questions about connecting?

Tell us what you’re building.