Integration Guide

MCP Server Setup

Connect Insiqta's insider transaction data to your favorite AI assistant. This guide walks you through setting up the MCP server with Claude, ChatGPT, VS Code, Cursor, and more.

Overview

Insiqta exposes a Model Context Protocol (MCP) server that lets AI assistants query real-time insider transaction data directly. Instead of copy-pasting data, your AI assistant can call Insiqta tools to search, filter, and analyze insider trades for you.

Connection details

Protocol: MCP over Streamable HTTP

Endpoint: https://api.insiqta.com/mcp

Auth: OAuth 2.0 or API key

Prerequisites

Before you start, make sure you have:

An Insiqta account
An active Pro-plan or higher (MCP access requires a Pro subscription)
Either an API key for quick setup, or OAuth for more secure integration (both covered below)

Authentication

Insiqta supports two authentication methods for MCP connections:

Option 1: OAuth 2.0 (Recommended)

Modern, secure authentication that doesn't require managing API keys. MCP clients will automatically guide you through a web-based login flow.

More secure - no long-lived tokens
Automatic token renewal
Easy revocation from web interface
No manual key management

Simply configure your MCP client with the server URL and it will automatically prompt for login when needed.

Option 2: API Key

Traditional API key authentication for clients that need persistent access or don't support OAuth flows.

Works with all MCP clients
Good for automated scripts
No interactive login required

Most modern MCP clients support OAuth 2.0 and will handle the authentication flow automatically. We recommend trying OAuth first, and falling back to API keys only if your client doesn't support OAuth.

Option 2: Get Your API Key

Click on your AI assistant below to see the setup instructions. Most examples show OAuth setup (no API key needed), with API key alternatives for clients that need them.

1
Log in to Insiqta and go to Settings.
2
Scroll down to the API Keys.
3
Click Create API Key andgive it a descriptive name (e.g., "Claude MCP" or "Cursor").
4
Copy the key immediately. It starts with ak_ and is only shown once. Store it somewhere safe.

Keep your API key private. Never share it publicly or commit it to version control. If you lose it, delete the old key and create a new one.

Client Setup Guides

Click on your AI assistant below to see the setup instructions. Replace ak_your_api_key with the API key you created above.

Claude Desktop supports MCP servers via a JSON config file. This connects Claude directly to Insiqta's data.

OAuth Setup (Recommended)

1
Open the Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
If the file doesn't exist, create it.

Add the Insiqta MCP server configuration (OAuth, no API key needed):

claude_desktop_config.json

{
  "mcpServers": {
    "insiqta": {
      "type": "streamable-http",
      "url": "https://api.insiqta.com/mcp"
    }
  }
}

3
Restart Claude Desktop for the changes to take effect.

API Key Setup (Alternative)

If OAuth doesn't work with your version of Claude Desktop, you can use API key authentication:

claude_desktop_config.json

{
  "mcpServers": {
    "insiqta": {
      "type": "streamable-http",
      "url": "https://api.insiqta.com/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_api_key"
      }
    }
  }
}

Once restarted, you should see Insiqta listed as an available MCP tool. With OAuth, Claude will automatically prompt you to log in when you first try to use Insiqta data. Try asking: "Show me the latest insider transactions for ASML."

Claude Code is Anthropic's command-line coding assistant. You can add the Insiqta MCP server with a single command.

Terminal

claude mcp add insiqta \
  --transport http \
  "https://api.insiqta.com/mcp" \
  --header "Authorization: Bearer ak_your_api_key"

That's it. The server will be available in your next Claude Code session. You can verify it's connected by running:

Terminal

claude mcp list

1
Go to claude.ai and open Settings.
2
Navigate to the Integrations.
3
Click Add Integration and select MCP Server.
4
Enter the server URL: https://api.insiqta.com/mcp
5
When prompted for authentication, enter your API key as a Bearer token.

Claude Web MCP integration requires a Claude Pro or Team plan from Anthropic.

1
Open ChatGPT Desktop and go to Settings > MCP Servers.
2
Click Add Server.
3
Enter a name (e.g., "Insiqta") and the server URL:
https://api.insiqta.com/mcp
4
For authentication, add a header:
Header
Authorization: Bearer ak_your_api_key
5
Save and start a new conversation. Insiqta tools will be available.

MCP support in ChatGPT is available on the ChatGPT Plus, Team, and Enterprise plans from OpenAI.

1
Open (or create) the Codex configuration file at ~/.codex/config.json.

Add the MCP server configuration:

~/.codex/config.json

{
  "mcpServers": {
    "insiqta": {
      "type": "http",
      "url": "https://api.insiqta.com/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_api_key"
      }
    }
  }
}

3
Start a new Codex session. The Insiqta tools will be automatically available.

1
Open (or create) opencode.json in your project root.

Add the MCP server block:

opencode.json

{
  "mcp": {
    "insiqta": {
      "type": "http",
      "url": "https://api.insiqta.com/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_api_key"
      }
    }
  }
}

3
Restart OpenCode. The Insiqta MCP tools will appear automatically.

VS Code supports MCP servers through GitHub Copilot's agent mode. You can configure it per-project or globally.

Per-project setup

Create a .vscode/mcp.json file in your project root:

.vscode/mcp.json

{
  "servers": {
    "insiqta": {
      "type": "http",
      "url": "https://api.insiqta.com/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_api_key"
      }
    }
  }
}

2
Open Copilot Chat in agent mode (click the agent icon or use the command palette). Insiqta tools will be listed.

Global setup

To make Insiqta available in all projects, add the server to your VS Code user settings (settings.json):

settings.json

{
  "mcp": {
    "servers": {
      "insiqta": {
        "type": "http",
        "url": "https://api.insiqta.com/mcp",
        "headers": {
          "Authorization": "Bearer ak_your_api_key"
        }
      }
    }
  }
}

MCP support in VS Code requires GitHub Copilot with agent mode enabled. Make sure you have the latest Copilot extension installed.

Cursor has built-in MCP support. You can configure it through the UI or via a config file.

Via Settings UI

1
Open Cursor and go to Settings > MCP.
2
Click Add MCP Server.
3
Select Type: HTTP andenter the URL: https://api.insiqta.com/mcp
4
Add the authorization header with your API key.

Via config file

Create or edit .cursor/mcp.json in your project root:

.cursor/mcp.json

{
  "mcpServers": {
    "insiqta": {
      "type": "streamable-http",
      "url": "https://api.insiqta.com/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_api_key"
      }
    }
  }
}

Restart Cursor after saving the file.

Troubleshooting

Common issues and how to resolve them:

Your API key is missing, invalid, or expired. Double-check that you've included the full key (starting with ak_) and that the Authorization header is formatted as Bearer ak_...

MCP access requires a Pro-plan or higher. Upgrade your subscription to enable MCP server access.

The MCP endpoint only accepts POST requests. If you see this error, your client may be misconfigured. Make sure the transport type is set to streamable-http or http (not SSE or stdio).

The MCP server allows up to 100 requests per second per user. If you hit this limit, wait a moment and try again. If you consistently need higher throughput, contact us.

Most clients require a restart after changing MCP configuration. Close and reopen the application, or restart the CLI session. Also verify that there are no JSON syntax errors in your config file.

Need help? Contact us and we'll help you get set up.

View pricing Open screener