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"

Microsoft Copilot

1. Navigate to Microsoft Copilot Studio

   1. https://copilotstudio.microsoft.com/

2. Select "Agents" on the left and then "+ Create Blank Agent" on the top right

   1. If using the New UI the button on the right is "New Agent"

3. Give your agent a name such as "Cork"

4. On the right hand side under "Tools" click "+"

5. On the popup, click "+ Add" and select "Model Context Protocol (MCP)"

6. Enter the following:

   1. Server name: Cork

   2. Server description: Allows interaction with the Cork Vantage API

   3. Server URL: https://api.corkinc.com/api/v1/mcp

   4. Authentication: OAuth 2.0

   5. Configuration type: Dynamic (with discovery)

   6. Click "Add"

7. Click the dropdown arrow next to "Connection" and select "Create new connection"

8. Optionally add a display name, then click "Create"

9. Paste your API key in the window that pops up

10. Click "Authorize"

11. In the "Preview" tab, start a new chat and ask "what tools are available through Cork?"

    1. This should list the operations available, if you get an error, try creating a new connection

    2. If you need to change the agent entirely, you will need to remove the customer connector through Power Automate

       1. https://make.powerautomate.com/

       2. Search for "Custom connectors"

       3. Find the connector named "Cork" and delete it, then start with Step 1 again

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