API Documentation - Nordic Financial News

Endpoint

POST https://nordicfinancialnews.com/mcp

Streamable HTTP transport. All requests use POST.

Quick Test

Verify your API key works by listing available tools:

curl -X POST https://nordicfinancialnews.com/mcp \ -H "Authorization:
          Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d
          '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

Authentication

Authenticate with a Bearer token in the Authorization header. The MCP server uses the same API keys as the REST API. Requires a Plus or Pro plan.

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json is required on all requests.

If you have an IP allowlist configured on your API key, make sure your AI client's IP addresses are included.

Setup

claude mcp add --transport http nordic-financial-news \
            https://nordicfinancialnews.com/mcp \ --header "Authorization:
            Bearer YOUR_API_KEY"

Requires the mcp-remote npm proxy. Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{ "mcpServers": { "nordic-financial-news": { "command": "npx",
            "args": [ "mcp-remote", "https://nordicfinancialnews.com/mcp",
            "--header", "Authorization: Bearer YOUR_API_KEY" ] } } }

Requires a full restart of Claude Desktop after saving.

Add to .cursor/mcp.json in your project:

{ "mcpServers": { "nordic-financial-news": { "type":
            "streamable-http", "url": "https://nordicfinancialnews.com/mcp",
            "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Available Tools

Tool	Description	Required Scope
search_articles	Full-text search articles; filter by country, category, ticker, date, content type	read:articles
search_stories	Search clustered article stories	read:stories
search_companies	Search companies by name or ticker; filter by country, exchange	read:companies
get_article	Retrieve full article with translated content	read:articles
get_story	Retrieve story with all related articles	read:stories
get_company	Lookup company by ID or ticker symbol	read:companies
list_countries	List Nordic countries with ISO2 codes	read:countries
list_categories	List news categories	read:categories
list_exchanges	List stock exchanges with MIC codes	read:exchanges
list_watchlist	List your followed companies	read:watchlist

Tools are filtered by your API key's scopes. If a tool doesn't appear, check that the required scope is enabled on your key. All scopes are enabled by default.

Resources

Two resources are available for priming conversation context without tool calls:

URI	Description
nordic-news:///recent-articles	10 most recent articles
nordic-news:///recent-stories	10 most recent stories

Resource support varies by client.

Example Prompts

Once connected, try asking your AI assistant:

“What are the latest news articles about Volvo?”

“Summarize trending stories from Sweden this week”

“Find companies listed on the Helsinki exchange”

“Show me recent press releases from Norwegian companies”

Troubleshooting

Error	Cause	Fix
Unauthorized: Invalid or missing API key	Missing or invalid Bearer token	Check your API key is active and correctly formatted
Unauthorized: API access not available on your plan	Free plan	Upgrade to Plus or Pro
Tool not appearing	Missing scope on API key	Enable the required scope in Settings → API Keys
Monthly API request limit exceeded	Hit monthly limit	Wait for reset or upgrade plan

MCP Server