{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"MCP Server"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mcp-server","__idx":0},"children":["MCP Server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Checkr Tenant API speaks the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://modelcontextprotocol.io"},"children":["Model Context Protocol"]}," (MCP) —"," ","the open standard that lets AI assistants like Claude, Cursor, and"," ","ChatGPT-with-tools talk to external systems through a structured tool"," ","interface."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect your AI assistant to one endpoint and it gets a typed catalog of"," ","operations for managing applicants, properties, orders, and reports. You ask"," ","the assistant in plain English (\"create an order for Jane at 100 Main St"," ","using the essential package\") and it picks the right tool, fills in the"," ","arguments from context, and returns the result."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":1},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST https://tenant.checkr.com/mcp/v1\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transport:"]}," HTTP, streamable JSON-RPC (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://modelcontextprotocol.io/specification/2024-11-05/basic/transports#streamable-http"},"children":["MCP Streamable HTTP spec"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer ckr_sk_<test|live>_..."]}," — the same API key"," ","you'd mint for any Checkr Tenant integration. Test and live keys both work."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["State:"]}," stateless. Every tool invocation carries its own bearer; there's"," ","no session to establish."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tools","__idx":2},"children":["Tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server exposes 12 tools covering applicants, properties, orders, and"," ","reports."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_applicants"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List applicants for your organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_applicant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single applicant by id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_applicant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a new applicant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_properties"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List properties for your organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_property"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single property by id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_property"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a new property."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_orders"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List orders for your organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single order by id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_order"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Place a screening order for an applicant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_order_report"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch the report attached to an order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_report"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single report by id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_report_pdf"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch a single report PDF."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connecting-a-client","__idx":3},"children":["Connecting a client"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Live keys place real orders"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ckr_sk_test_"]}," key. Swap to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ckr_sk_live_"]}," only after you've"," ","watched the assistant's tool calls in your client and are confident in the"," ","prompts driving them. An AI assistant with a live key can create"," ","applicants, place screening orders, and incur charges on your behalf."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"claude-code","__idx":4},"children":["Claude Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the server from the CLI. Keep the key out of your shell history by"," ","exporting it first (or using your shell's prefix-with-space convention)"," ","rather than pasting it inline:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"export CHECKR_API_KEY=ckr_sk_test_...\nclaude mcp add --transport http checkr-tenant https://tenant.checkr.com/mcp/v1 \\\n  --header \"Authorization: Bearer $CHECKR_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify it registered with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude mcp list"]},". New conversations pick it up"," ","automatically; restart any open session to load the tools."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also configure the server in JSON — drop this into your"," ","user-scoped ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.claude.json"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"checkr-tenant\": {\n      \"type\": \"http\",\n      \"url\": \"https://tenant.checkr.com/mcp/v1\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ckr_sk_test_...\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"cursor","__idx":5},"children":["Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open Cursor's settings, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add new MCP server"]},", and pick"," ","the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP"]}," transport. Set:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkr-tenant"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://tenant.checkr.com/mcp/v1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer ckr_sk_test_..."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save and reload Cursor. Equivalent JSON form, if you'd rather edit"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.cursor/mcp.json"]}," directly — this file lives outside any repo, which is"," ","the right place for a key. Don't paste a live key into a project-scoped"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]}," that might be committed:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"checkr-tenant\": {\n      \"type\": \"http\",\n      \"url\": \"https://tenant.checkr.com/mcp/v1\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ckr_sk_test_...\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The tools will appear under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkr-tenant"]}," in the next chat."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-interactions","__idx":6},"children":["Example interactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once connected, you can drive the API conversationally. A few prompts that"," ","land directly on tool calls:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"List my applicants.\""]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_applicants"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Create an applicant named Jane Renter, email jane@example.com.\""]}," →"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_applicant"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Order an essential screening for Jane at 100 Main St, San Francisco CA 94117.\""]}," ","→ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_order"]}," (creating the property inline)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Show me my recent orders.\""]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_orders"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"What's the status of order ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ord_test_..."]},"?\""]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_order"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Pull the report from that order.\""]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_order_report"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The assistant chooses the tool, fills in arguments from the conversation"," ","context (including pretty IDs returned by earlier calls), and surfaces the"," ","result. You stay in plain English; the wire format never surfaces."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"auth-and-key-management","__idx":7},"children":["Auth and key management"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Bearer tokens must start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ckr_sk_"]}," (test or live)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Revoked or expired keys return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}," immediately."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mint an API key from the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://tenant.checkr.com/settings/developer"},"children":["API Keys settings page"]},"."]}]},"headings":[{"value":"MCP Server","id":"mcp-server","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Tools","id":"tools","depth":3},{"value":"Connecting a client","id":"connecting-a-client","depth":3},{"value":"Claude Code","id":"claude-code","depth":4},{"value":"Cursor","id":"cursor","depth":4},{"value":"Example interactions","id":"example-interactions","depth":3},{"value":"Auth and key management","id":"auth-and-key-management","depth":3}],"frontmatter":{"seo":{"title":"MCP Server"}},"lastModified":"2026-06-22T19:09:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}