Skip to content

Quick Start

Connect LexSocket MCP servers to your favourite AI client in under 5 minutes.

Prerequisites

Create your LexSocket account first by clicking Start for free or Login at lexsocket.ai.

Choose Your Connection Method

The fastest way to get started. The Claude Marketplace installs all 3 connectors (TED, National Tenders, EUR-Lex) in one step.

Claude Desktop

1. Open Plugins

Click the Plugins icon in the sidebar, then go to the Personal tab.

Open the plugin menu

2. Add the LexSocket marketplace

Click Add marketplace from GitHub and enter:

lexsocket/marketplace

Add marketplace from GitHub

Enter lexsocket/marketplace

3. Install the Tenders plugin

Click on the tenders plugin in the marketplace to install it.

Tenders plugin in the marketplace

Plugin installation confirmation

Done — all 3 connectors are ready

TED, National Tenders, and EUR-Lex are now available. Type /tenders in the chat to start.

Using the /tenders command

Claude Code

1. Add the marketplace

/plugin marketplace add lexsocket/marketplace

2. Install the plugin

/plugin install tenders@lexsocket

3. Authenticate

Run /mcp and follow the OAuth2 login in your browser.

4. Verify

/tenders:hello

Done — all 3 connectors are ready

TED, National Tenders, and EUR-Lex are available in your Claude Code session.

For any MCP client that supports JSON configuration (Claude Desktop, Cursor, Windsurf, etc.). Uses OAuth — no API key needed.

Add this to your client's MCP configuration file (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "lexsocket-national-tenders": {
      "url": "https://mcp.lexsocket.ai/national_tenders"
    },
    "lexsocket-ted": {
      "url": "https://mcp.lexsocket.ai/ted"
    },
    "lexsocket-eurlex": {
      "url": "https://mcp.lexsocket.ai/eurlex"
    }
  }
}

Pick only what you need

You can add all 3 servers or just the ones you need. Each server is independent.

Server URL Description
National Tenders https://mcp.lexsocket.ai/national_tenders Below-threshold tenders across 18 countries
TED https://mcp.lexsocket.ai/ted Above-threshold EU procurement (Tenders Electronic Daily)
EUR-Lex https://mcp.lexsocket.ai/eurlex EU legislation, directives, regulations, case law

After adding the configuration, restart your AI client. OAuth authentication will be triggered automatically on first use.

For clients that don't support OAuth (Le Chat, Cherry Studio, custom integrations). Requires an API key from your LexSocket dashboard.

1. Get Your API Key

Log in to lexsocket.ai, click Dashboard, then Create key.

LexSocket dashboard link

LexSocket — Create API key

2. Add to your configuration

{
  "mcpServers": {
    "lexsocket-national-tenders": {
      "url": "https://mcp.lexsocket.ai/national_tenders",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    },
    "lexsocket-ted": {
      "url": "https://mcp.lexsocket.ai/ted",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    },
    "lexsocket-eurlex": {
      "url": "https://mcp.lexsocket.ai/eurlex",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

Keep your key safe

Never commit your API key to version control. Use environment variables or secret managers in production.

Client-Specific Guides

Le Chat (Mistral)

Le Chat requires an API key for MCP authentication.

1. Get your API key from the LexSocket dashboard (see API Key tab above).

2. Open chat.mistral.ai and click Create connector.

Le Chat — Create connector button

3. Select Custom MCP.

Le Chat — Custom MCP option

4. Enter the server URL and select API Token as the authentication method.

Server URL
TED https://mcp.lexsocket.ai/ted
National Tenders https://mcp.lexsocket.ai/national_tenders
EUR-Lex https://mcp.lexsocket.ai/eurlex

Le Chat — server URL and API Token authentication

5. Paste your LexSocket API key in the token field.

Le Chat — paste API key

You're all set!

Ask Le Chat a question like "Find active construction tenders in France" and it will call the LexSocket MCP tools automatically.

Le Chat — connector active in the list

Cherry Studio

Cherry Studio supports MCP servers via its settings panel. Configure a new MCP server with:

Field Value
Name LexSocket TED (or National Tenders, EUR-Lex)
Type Streamable HTTP (streamableHttp)
URL https://mcp.lexsocket.ai/ted
Headers Content-Type: application/json
x-api-key: YOUR_API_KEY
Timeout 60s

Repeat for each server you want to add.

Cursor

Add the following to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "lexsocket-national-tenders": {
      "url": "https://mcp.lexsocket.ai/national_tenders"
    },
    "lexsocket-ted": {
      "url": "https://mcp.lexsocket.ai/ted"
    },
    "lexsocket-eurlex": {
      "url": "https://mcp.lexsocket.ai/eurlex"
    }
  }
}

OAuth authentication is handled automatically.

ChatGPT (via plugins)

ChatGPT supports MCP servers through its plugin system. Use the same server URLs with your API key:

Server URL
National Tenders https://mcp.lexsocket.ai/national_tenders
TED https://mcp.lexsocket.ai/ted
EUR-Lex https://mcp.lexsocket.ai/eurlex

Any MCP Client

LexSocket works with any client that supports the Model Context Protocol. Use the server URLs from the JSON Config or API Key tabs above, depending on whether your client supports OAuth.

Authentication When to use
OAuth (no key needed) Claude Desktop, Claude Code, Cursor, Windsurf
API Key (from dashboard) Le Chat, Cherry Studio, ChatGPT, custom agents

Try a Query

Once connected, try a natural language question:

"What are the latest TED tenders for IT services in Germany?"

Your AI agent will automatically call the appropriate MCP tools and return structured results.

Claude Desktop — query results for IT services tenders in Germany

Next Steps