Cork Public API & MCP Server

Cork provides two ways to integrate with platform data:

• Public REST API: Standard REST endpoints for accessing integrations, risk insights, and asset data
• MCP Server: Wraps the REST API for use with MCP-compatible LLMs like Claude, Cursor, LangChain, or Windmill
  • All read-only endpoints are exposed as MCP tools

Note: Both options require an API key for authentication.

Where is the documentation?

Documentation is available at https://api.corkinc.com/api/docs

How can I generate keys in the platform?

Estimated time: 1-2 minutes

In the Cork platform, you can generate keys by following these steps

1. Open the Admin tab
2. Select API Keys
3. Click "Add API Key"
4. Select a name and timeframe for when the API key should expire
5. Generate and securely store your key

Note: API key permissions are linked to the users who create them

MCP Setup

Estimated time: 5-10 minutes

General MCP Configuration

MCP (Model Context Protocol) requires configuration through an mcp.json file (or similar) that defines available servers and their credentials. This file is typically located in your MCP client's configuration directory.

Cork MCP Configuration

1. Install an MCP-compatible client (Claude Desktop, Cursor, etc.)

2. Add Cork MCP server to your mcp.json with your API credentials:

   {
     "mcpServers": {
       "cork": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://api.corkinc.com/api/v1/mcp",
           "--header",
           "Authorization:${AUTH_HEADER}"
         ],
         "env": {
           "AUTH_HEADER": "Bearer YOUR_API_KEY"
         }
       }
     }
   }

3. Configure authentication by replacing YOUR_API_KEY with the API key generated from your Cork platform account

Detailed MCP server installation and configuration instructions are available on https://api.corkinc.com/api/docs#description/use-with-mcp

Example MCP Queries

Once configured, you can use prompts like:

Inactive devices

Identify all devices from my integrations that haven't been seen for more than 2 weeks.

Clients by compliance events

List all clients sorted by number of compliance events, and prioritize which ones should be addressed first.

Warranties expiring soon

List all clients with warranties expiring in the next 30 days and highlight any critical assets.