• CONFIG
  • ID
  • DETAILS
  • HUMAN

How to retrieve workspace metadata with your AI

Connect Segment to your AI client to pull configuration data instantly. Your agent can query your workspace structure without you digging through the Segment UI.

Ask AI about this page

Short answer

How can I get my Segment workspace info using AI?

Your AI uses the Segment MCP to call specific tools that fetch your workspace details and source lists. You'll get exact namespace IDs and source configurations through simple chat commands. This setup gives you a direct line to your Segment metadata.

Data outcomes

What your agent pulls from Segment.

The specific information your AI can retrieve.

CONFIG

Source configurations

The AI pulls specific details about your connected sources. You get the exact setup parameters for each data stream.

ID

Namespace IDs

Your agent retrieves the unique identifiers for your workspaces. This makes it easy to reference specific environments in other tasks.

DETAILS

Workspace metadata

Get a clear view of your workspace settings. The AI gathers the high-level details you need to understand your Segment structure.

HUMAN

Manual adjustments

The AI only reads existing data. You still need to log in to the Segment dashboard if you want to change settings or add new sources.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat interface and the Segment API.

  1. Identify the workspace

    The agent first locates the specific workspace you are asking about to ensure it targets the right data.

    get_workspace

  2. List active sources

    Once the workspace is identified, the AI scans for all configured data sources within that environment.

    list_sources

  3. Extract identifiers

    The agent pulls the specific namespace IDs and configuration strings required for your task.

    get_workspacelist_sources

  4. Format the response

    The AI translates the raw JSON data from Segment into a readable summary for your chat window.

    get_workspace

Try it

Copy these to start.

Use these prompts to begin interacting with your Segment data.

Starting points

Replace the bracketed text with your actual Segment workspace or source names.

Segment Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_oCSWGNyPpMslZfXLGFWI7A5SYVuHGSeAvjoUSWuf/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Segment capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "segment-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_oCSWGNyPpMslZfXLGFWI7A5SYVuHGSeAvjoUSWuf/mcp"
    }
  }
}
Copy into chat04

  • What are the details for my 'Production' workspace?

  • List all the sources currently active in my Segment workspace.

  • Find the namespace ID for my main data stream.

  • Show me the configuration for the 'Mobile App' source.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Segment once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted, and you can immediately start asking questions about your Segment setup.

Connect Segment to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my Segment source settings?

    No. The tools only allow the AI to retrieve existing metadata. You must use the Segment UI to make any changes.

  • 02

    Can I delete a source using my AI client?

    No. This MCP is designed for data retrieval, not for modifying or deleting your Segment configurations.

  • 03

    Does the AI see all my Segment data?

    The AI only sees the specific workspace and source information it retrieves through its tools based on your questions.

  • 04

    How does the AI know which workspace to look at?

    You tell the AI which workspace you are interested in, and it uses that information to call the correct tool.

  • 05

    Do I need to provide API keys every time I ask a question?

    No. You connect the Segment MCP once, and Vinkius manages the connection for you.

  • More questions about Segment? See everything the Segment Connector can do

Connect Segment to Claude, Cursor, ChatGPT & more