MCP Setup Guide

Give your AI tools direct access to 100+ Danish news sources. Zero install. One config block. Works immediately.

1Get your API key

Sign up and create an API key. Takes 30 seconds. The key starts with ob_live_.

2Add to your AI tool

Claude Desktop

Settings → Developer → Edit Config → paste this:

claude_desktop_config.json
{
  "mcpServers": {
    "orbis-news": {
      "url": "https://mcp.orbis.builders/mcp",
      "headers": {
        "X-API-Key": "ob_live_your_key_here"
      }
    }
  }
}

Cursor

Create this file in your project root:

.cursor/mcp.json
// .cursor/mcp.json
{
  "mcpServers": {
    "orbis-news": {
      "url": "https://mcp.orbis.builders/mcp",
      "headers": {
        "X-API-Key": "ob_live_your_key_here"
      }
    }
  }
}

Kiro

Add to your workspace or global config:

.kiro/settings/mcp.json
// .kiro/settings/mcp.json
{
  "mcpServers": {
    "orbis-news": {
      "url": "https://mcp.orbis.builders/mcp",
      "headers": {
        "X-API-Key": "ob_live_your_key_here"
      }
    }
  }
}

ChatGPT

ChatGPT supports MCP through custom connectors:

  1. Go to Settings → Connected Apps → Add custom MCP connector
  2. Set the URL to: https://mcp.orbis.builders/mcp
  3. Add a header: X-API-Key with your API key as the value
  4. Save, and the Orbis tools appear in your next conversation
Tip: Never paste your API key directly into a chat message. Always configure it through the connector settings so it's sent securely in headers.

Windsurf / Other MCP clients

Any MCP client that supports Streamable HTTP works. Use these settings:

  • URL: https://mcp.orbis.builders/mcp
  • Transport: Streamable HTTP (or HTTP+SSE)
  • Auth header: X-API-Key: ob_live_your_key

3Start asking

Once connected, just talk naturally. Here are some things to try:

You: "Search for news about Danske Bank from the last week"
You: "Create a monitor for articles mentioning klimapolitik"
You: "How has coverage of Novo Nordisk changed over the past month?"
You: "What are the biggest stories on dr.dk right now?"
You: "Show me all the sites covering the new climate agreement"

Available Tools

These are the tools your AI can call. You don't need to know these. Just ask naturally and the AI picks the right one.

search_news

Search articles by keyword or natural language query. Supports keyword, semantic, and hybrid modes.

Try: "Search for news about Danske Bank from the last week"

list_agents

List your monitoring agents and their status (active, paused, article counts).

Try: "Show me my monitoring agents"

create_agent

Create a keyword monitoring agent that continuously collects matching articles.

Try: "Create a monitor for articles about klimapolitik"

get_agent_articles

Get the latest articles collected by a monitoring agent.

Try: "What new articles did my Novo Nordisk monitor find?"

pause_agent

Pause an agent (stops collecting, preserves existing articles).

Try: "Pause my climate policy monitor"

get_article

Get full article details including cross-site coverage stats.

Try: "Get details on article 89234012"

get_thread

Get all coverage of a story across different news sources.

Try: "Show me how different sites covered this story"

get_timeline

Track topic coverage over time (daily/weekly/monthly buckets).

Try: "How has Novo Nordisk coverage changed over the past month?"

list_sites

List available news sources and their current activity level.

Try: "What news sites do you have access to?"

get_usage

Check your API usage and remaining monthly quota.

Try: "How many API requests do I have left?"

Signal agents

Signal agents turn news into structured events, for example company sales or appointments. Your AI can read your existing signal agents and their events, and can design, preview and create a new one. Everything runs as the OrbisX account that owns the API key.

  • Verified email required. Sign in to the portal once with the email of your account and confirm it. Until then the signal tools answer that your email must be confirmed.
  • You need an OrbisX account with the same email. Create it at orbisx.ai if you have none.
  • Quota. Signal agents are included according to your OrbisX plan. Each agent uses one slot. When all slots are in use, creating another is refused with a message pointing to orbisx.ai, where you can change your plan. Reading events and previewing do not use a slot.
  • Create is real. create_signal_agent starts a 30-day backfill straight away. Your AI should validate and preview first, and ask you before creating.
  • Previews are asynchronous. Start one, then check it with get_signal_preview. Only one preview runs at a time and there is a daily limit.
list_signal_agents

List your signal agents (research agents that extract structured events), with id, title and country.

Try: "Which signal agents do I have?"

get_signal_agent_events

Read the events an agent has found. Supports filters, sorting and cursor pagination.

Try: "Show the latest events from my company-sales agent"

get_signal_agent_event

Get one event with all its properties and source articles.

Try: "Show me event 5 in full"

get_signal_agent_summary

Counts and overview of an agent's events.

Try: "Summarise what this agent has found"

get_signal_agent_event_months

Event counts per month for an agent.

Try: "How many events per month?"

get_signal_agent_catalog

The event types, properties and filters available on one agent.

Try: "What can I filter on for this agent?"

get_signal_quota

How many signal agents your plan includes and how many are in use.

Try: "How many signal agents can I still create?"

get_signal_catalog

The catalog of ready-made event types to build a new signal agent from.

Try: "What kinds of events can an agent track?"

get_signal_schema_format

The search schema format and rules for describing the events you want.

Try: "Explain how to describe the events I want"

get_signal_criteria_fields

The fields that can be used in criteria and alerts.

Try: "Which fields can I filter on?"

validate_signal_schema

Check a search schema for errors before previewing. Free to call.

Try: "Is this schema valid?"

start_signal_preview

Start a small, time-limited sample run of a schema. Returns at once with a preview id.

Try: "Preview this agent on 20 articles"

get_signal_preview

Check on a running preview and read its sample events.

Try: "How is the preview going?"

stop_signal_preview

Stop a running preview.

Try: "Stop the preview"

create_signal_agent

Create the signal agent. Starts a real 30-day backfill and uses one signal agent slot from your quota. Needs an idempotency_key so a retry never creates a second agent.

Try: "Create this agent now"

Troubleshooting

"Connection failed" or "Tool not found"

Make sure the URL is exactly https://mcp.orbis.builders/mcp, no trailing slash, no extra path.

"Invalid API key"

Check your key starts with ob_live_ and is the full key (48 characters), not the truncated prefix shown in the dashboard.

"Quota exceeded"

You've hit your monthly limit. Upgrade your OrbisX plan or wait for the next billing cycle.

Tools not showing up in ChatGPT

Start a new conversation after adding the connector. ChatGPT loads MCP tools at conversation start, not mid-conversation.