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?"

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 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.