Model Context Protocol (MCP)

Welcome to the Compliancely Model Context Protocol (MCP) Server documentation. This guide provides comprehensive instructions for integrating Compliancely's verification services directly into your development environment through the Model Context Protocol.

Overview

The Compliancely MCP Server enables AI assistants and development tools to interact seamlessly with Compliancely's enterprise platform. By integrating this server, you can perform identity verification, business verification, sanctions screening, address validation, and tax compliance checks directly from your IDE or AI assistant.

What is MCP?

The Model Context Protocol (MCP) is an open protocol that enables AI assistants to securely access external data sources and tools. By using MCP, Compliancely services become available as native tools within your AI-powered development environment. Know more about MCP here

Natural Language

Use simple sentences to run the checks. No code needed. Great for quick tests and team work.

Secure OAuth 2.1

Uses top OAuth 2.1 security with JWT tokens and passes requests securely to APIs.

Works in Your IDE

Type prompts in Cursor/VS code to call MCP APIs and get auto-complete help.

Connect to Compliancely's MCP:

OAuth Authentication

The Compliancely MCP server implements OAuth 2.1 authorization per the MCP spec. This approach provides stronger security than direct access tokens through granular scopes and user-specific permissions.

Adding Compliancely MCP to your client triggers a simple OAuth consent screen. You review and approve exactly what data the client can access in your Compliancely account.

Key Benefits

PKCE Required: Protects against authorization code interception
Dynamic Registration: Auto-registers clients without manual setup
HTTPS Only: All endpoints require secure connections
Token Rotation: Automatic refresh prevents long-lived tokens

Setup Using IDE

Cursor IDE

To open Cursor and automatically add the Compliancely MCP - Install in Cursor

Alternatively, add the following to your ~/.cursor/mcp.json file. To learn more, see the Cursor documentation

{
  "mcpServers": {
    "compliancely": {
      "url": "https://mcp.compliancely.com/mcp"
    }
  }
}

To Setup Using Cursor IDE Directly ,

Open Cursor and click the Settings (⚙️) icon in the top-right corner.
Select Tools & MCP and click Add Custom MCP (or) New MCP Server.
mcp.json will be opened. Add server configuration:
1. Provide a name for the server.
2. Add Compliancely MCP server URL ("https://mcp.compliancely.com/mcp") as shown below
```
{
  "mcpServers": {
    "compliancely": {
      "url": "https://mcp.compliancely.com/mcp"
    }
  }
}
```
3. Save Configuration file.
Cursor will automatically starts the server and displays its status in the MCP Server list.
Open a new chat by clicking the + icon and type a quick test prompt such as "Check Compliancely MCP connection" to confirm it's active.

Visual Studio Code

To open VS Code and automatically add the Compliancely MCP - Install in VS Code

Alternatively, add the following to your ~/.vscode/mcp.json file. To learn more, see the VS Code documentation

{
  "servers": {
    "compliancely": {
      "type": "http",
      "url": "https://mcp.compliancely.com/mcp"
    }
  }
}

Available Tools

The Compliancely MCP Server unlocks powerful compliance verification tools. Always enable human approval for tool usage and be cautious when connecting to other MCP servers to prevent prompt injection risks. Share feedback or tool requests via email at [email protected].

❗️
Usage Warning (Mandatory)
Cost Warning: Using MCP tools—especially POST operations—may incur usage charges. AI models may call tools multiple times in a single prompt depending on the context they infer. Use prompts carefully to avoid unintended API calls.

Resource	Tool	API
IRS TIN Match	request_tin_match	TIN Match Request
	retrieve_tin_match	GET TIN Match Status By ID
	request_hybrid_tin_match	TIN Match (Hybrid)
	list_tin_match	Get All Requests
US Address Verification	request_address_verification	US Address Verification Search
	retrieve_address_verification	US Address Verification Search by ID
	list_address_verification	Get All Address Verification Requests
IRS Tax Exempt	request_tax_exempt_status	Tax Exempt Search
	list_tax_exempt_checks	Get Tax Exempt Results
IRS Services	retrieve_irs_status	Get IRS Status
US - Watchlists	request_ofac_check	Request OFAC Search
	list_ofac_checks	Get OFAC Results
	request_dmf_check	Request DMF Search
	list_dmf_checks	Get DMF Results
Canada Business Services	request_canada_business	Request CA Business Search
	retrieve_canada_business	Get CA Business Search Results
	request_canada_gsthst_registry	Request CA GST/HST Search
	retrieve_canada_gsthst_registry	Get CA GST/HST Results

The server exposes selected API operations as tools, allowing controlled execution from an LLM environment.