Tutorial: Financial Markets

Finance

Data source: ECB, Norges Bank, FRED, SEC EDGAR

Overview

Financial Markets searches across 4 data sources (ECB, Norges Bank, FRED, SEC EDGAR) in a single query. It deduplicates and normalizes results, saving you from building 4 separate integrations. This tutorial walks through all 3 tools with working code examples.

Prerequisites

Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config

{
  "mcpServers": {
    "gnist-financial-markets": {
      "url": "https://context.gnist.ai/mcp/financial-markets/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (3)

`search_financial_markets`

Search across exchange rates, commodities, ETF holdings, and insider trading. Queries five financial data sources in parallel: - ECB exchange rates (30+ currencies, uses query as base currency if 3-letter code) - ECB & Norges Bank policy rates (latest monetary policy decisions) - Commodity prices via FRED (energy, metals, agriculture — matches by name/category) - ETF holdings via SEC EDGAR (interprets query as fund ticker) - Insider trading via SEC Form 4 (interprets query as company ticker) Examples: search_financial_markets(query="USD") # USD exchange rates + policy rates search_financial_markets(query="gold") # gold + precious metals prices search_financial_markets(query="AAPL") # Apple insider trading + ETF exposure search_financial_markets(query="SPY") # SPY ETF holdings + insider activity

Parameter	Type	Required	Description
`query`	string	required	Currency code (e.g. 'USD'), commodity name (e.g. 'gold'), stock ticker (e.g. 'AAPL'), or general term.
`limit`	integer	optional	Max results per source. (default: `10`)

curl -X POST "https://context.gnist.ai/mcp/financial-markets/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_financial_markets", "arguments": {"query": "'USD'"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/financial-markets/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'query': "'USD'"},
            'name': 'search_financial_markets'}},
)
print(resp.json())

`list_financial_sources`

List all financial market data sources, their coverage, and data types. Shows which exchange rate providers, commodity databases, and SEC filing sources are queried during a financial markets search. Examples: list_financial_sources()

curl -X POST "https://context.gnist.ai/mcp/financial-markets/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_financial_sources", "arguments": {}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/financial-markets/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {}, 'name': 'list_financial_sources'}},
)
print(resp.json())

`report_feedback`

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	string	required
`feedback_type`	string	optional	(default: `general`)

curl -X POST "https://context.gnist.ai/mcp/financial-markets/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/financial-markets/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

Common Patterns

Pagination
Several tools support limit, offset, or page parameters. Start with small limits during development, then increase for production queries.

FAQ

What data does Financial Markets provide?

Unified financial market intelligence across ECB/Norges Bank exchange rates, FRED commodity prices, SEC EDGAR ETF holdings, and SEC Form 4 insider trading. It exposes 3 tools: search_financial_markets, list_financial_sources, report_feedback.

What do I need to get started?

A Gnist API key (free tier: 100 calls/day). Sign up at https://context.gnist.ai/signup.

What format does the Financial Markets API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.

Which data sources does Financial Markets aggregate?

ECB, Norges Bank, FRED, SEC EDGAR. Results are deduplicated and normalized into a consistent format.