Cork Public API & MCP Server

API for accessing Cork platform data

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 tools like Claude (Web, Desktop, Code), ChatGPT, Gemini CLI, etc

Where is the REST API 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

Claude (Web) & Claude Desktop

1. Navigate to Customize > Connectors

2. Click the + icon and click "Add custom connector"

3. Enter the following:

   1. Name: Cork

   2. Remote MCP Server URL: https://api.corkinc.com/api/v1/mcp

4. Click "Add", it should drop you into the OAuth flow automatically

5. Enter your API key and click "Authorize"

Claude Code

1. Open a new terminal window

2. Run the following command:

   claude mcp add cork --transport http https://api.corkinc.com/api/v1/mcp

3. Open a new Claude Code session by running claude

4. Run /mcp within the Claude Code session and authorize the Cork MCP connection

   1. It should drop you into the OAuth flow automatically

5. Enter your API key and click "Authorize"

ChatGPT

1. Navigate to your account settings

2. Click "Apps" and select "Advanced settings"

3. Ensure Developer Mode is enabled

4. Go back to "Apps" and click "Create app"

5. Enter the following:

   1. Name: Cork

   2. MCP Server URL: https://api.corkinc.com/api/v1/mcp

   3. Authentication: OAuth

   4. Leave all other options blank

6. Check the box next to "I understand and want to continue"

7. Click "Create", it should drop you into the OAuth flow automatically

8. Enter your API key and click "Authorize"

Gemini CLI

1. Open a new terminal window

2. Run the following command:

   gemini mcp add cork https://api.corkinc.com/api/v1/mcp --transport http

3. Open a new Gemini CLI session by running gemini

4. Run /mcp auth cork and select "Yes", it should drop you into the OAuth flow automatically

5. Enter your API key and click "Authorize"

Through mcp.json or schema that supports MCP servers

Update your configuration to include a new Cork MCP server:

{
  "mcpServers": {
    "cork": {
      "url": "https://api.corkinc.com/api/v1/mcp"
    }
  }
}

The next time you launch your tool it should prompt you to authorize, enter your API key and click "Authorize"

Manually with tools that do not support OAuth

Update your configuration to include a new Cork MCP server with specified authentication:

{
  "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"
      }
    }
  }
}

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.