MCP Server

AI agent interface for background checks using the Model Context Protocol. Works with Claude, GPT, and any MCP-compatible agent.

Setup with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gonos": {
      "command": "uvx",
      "args": ["--from", "gonos-mcp", "gonos-mcp"],
      "env": {
        "GONOS_API_KEY": "td_live_your_key_here",
        "GONOS_BASE_URL": "https://api.gonos.co"
      }
    }
  }
}

Setup with Claude Code

claude mcp add gonos -- gonos-mcp

Available tools (21)

Candidates

Tool	Description
`candidates_create`	Create a new candidate
`candidates_get`	Get candidate by ID
`candidates_list`	List candidates (paginated)
`candidates_update`	Update candidate fields
`candidates_delete`	Delete a candidate

Consent

Tool	Description
`consent_create`	Create hosted consent session (returns URL)
`consent_get`	Check consent status
`consent_list`	List consent sessions

Checks

Tool	Description
`checks_create`	Create a background check
`checks_get`	Get check status
`checks_list`	List checks (filter by status)
`checks_cancel`	Cancel a pending check

Reports

Tool	Description
`reports_get`	Get report for a completed check
`reports_items`	Get individual check items

Adverse actions

Tool	Description
`adverse_actions_create`	Initiate FCRA adverse action (5-day waiting period)
`adverse_actions_get`	Get adverse action status
`adverse_actions_finalize`	Finalize after waiting period

Disputes

Tool	Description
`disputes_create`	File a dispute (30-day reinvestigation deadline)
`disputes_get`	Get dispute status
`disputes_list`	List disputes

Webhooks

Tool	Description
`webhooks_create`	Register webhook endpoint
`webhooks_list`	List webhooks
`webhooks_delete`	Delete webhook

Example workflow

Ask your AI agent:

"Create a candidate named Jane Doe with email jane@example.com, then run a standard employment background check on her."

The agent will automatically:

Call candidates_create with first_name, last_name, email
Call consent_create with the candidate_id
Call checks_create with candidate_id and package="standard"
Poll checks_get until status is "completed"
Call reports_get to view the results