Smile Checks MCP Server

Model Context Protocol (MCP) server for the Smile Checks Integration API.

Features

• 7 core API tools:
  • initiate_check
  • check_status
  • list_check_requests
  • get_check_request
  • get_reports
  • cancel_check
  • get_credit_balance
• 2 convenience tools:
  • list_check_types
  • get_webhook_deliveries
• Local stdio mode for Claude Desktop
• Remote StreamableHTTP mode for hosted deployments

Install

cd mcp-server
npm install
npm run build

Run (stdio)

cd mcp-server
npm run start

Run (StreamableHTTP)

cd mcp-server
PORT=8788 npm run start:http

Claude Desktop Config Example

{
  "mcpServers": {
    "smile-checks": {
      "command": "node",
      "args": ["/absolute/path/to/verifier-central/mcp-server/dist/index.js"]
    }
  }
}

Authentication

Each MCP tool call requires apiKey as an input field. The server forwards this value as X-API-Key to https://api.getsmilechecks.com/v1.

Notes

• All Snowflake IDs must be treated as strings.
• get_webhook_deliveries requires the api-webhook-deliveries edge function in this repo.