How to Use the Lucidya MCP in Claude Code

Q: How do I connect Lucidya to Claude Code?

Run the claude mcp add command in your terminal with the server URL. It will be available for all your headless scripts immediately.

Claude Code runs headless Lucidya queries for your terminal pipelines and automated social data exports.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Lucidya MCP to Claude Code

Create your Vinkius account to connect Lucidya to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Lucidya with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless analytics for CI pipelines

Pipe `get_omniserve_analytics` output directly into your terminal scripts or build processes. This server gives you a clean way to pull KPIs without a browser. It is built for automation. You can schedule jobs that query your performance metrics and log the results to your terminal in a standard format.

Automated regional dialect detection

Run `detect_arabic_dialect` as part of your shell scripts to categorize social data as it streams in. It is a quick way to filter large volumes of text based on origin. This tool is optimized for high-throughput tasks. It returns the dialect metadata in a machine-readable format that your scripts can handle immediately.

Terminal-based monitor auditing

Use `list_social_monitors` to audit your active tracking jobs from the command line. It lists everything current so you can verify your coverage in seconds. You can chain this with other CLI tools to monitor your social health. It keeps your workflow inside the terminal where you prefer to work.

Setup guide

Set up Lucidya MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see lucidya-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Lucidya transactions." It will automatically discover and invoke the available Lucidya tools.

Terminal

claude mcp add --transport http lucidya-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Lucidya MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "lucidya-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lucidya. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Lucidya now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Lucidya MCP in Claude Code

Run the `claude mcp add` command in your terminal with the server URL. It will be available for all your headless scripts immediately.

Yes. Since it is a CLI-based MCP Server, you can include it in any automated task that runs via your terminal.

It returns standard JSON, so you can pipe the output to tools like `jq` or other downstream processors.

Your endpoint token is stored securely in your local configuration. It handles auth for every command you run.

The connection uses an encrypted transport layer. We only pull the monitor IDs and metadata required for your specific query, ensuring nothing is cached locally.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript