AI Agents + MCP

Beta

Connect AI agents to Cayman Journal's financial data using the Model Context Protocol. Access stock quotes, SEC filings, press releases, and news articles — all through a single MCP server.

12 Tools5 RSS FeedsReal-time QuotesAI Summaries

Quick Start

Add the Cayman Journal MCP server to your AI tool of choice. No API key required.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cayman-journal": {
      "url": "https://caymanjournal.com/api/mcp"
    }
  }
}

Available Tools

12 tools covering articles, market data, press releases, and SEC filings.

search_articles

Articles

Search and browse news articles. Filter by category, paginate through results.

querystring?Category slug to filter by

pageint?Page number (default: 1)

limitint?Results per page (default: 10, max: 50)

get_article

Articles

Get full article content by ID including processed content, authors, and SEO metadata.

idstringArticle ID

list_categories

Articles

List all available news categories and their subcategories.

get_stock_quote

Markets

Get real-time stock quote including price, change, volume, market cap, and trading session info.

symbolstringTicker symbol (e.g. "AAPL")

search_stocks

Markets

Search for stock symbols by company name or ticker. Returns matching symbols with exchange info.

querystringSearch query

get_company_profile

Markets

Get company profile including sector, industry, description, CEO, employees, and website.

symbolstringTicker symbol

get_key_statistics

Markets

Get key financial statistics: market cap, P/E ratio, EPS, 52-week range, dividends.

symbolstringTicker symbol

get_historical_data

Markets

Get historical OHLCV price data for a stock over a specified time period.

symbolstringTicker symbol

periodstring?"1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "max"

get_press_releases

Press

Get press releases for a specific stock ticker with title, excerpt, source URL, and linked article.

tickerstringTicker symbol

pageint?Page number

limitint?Results per page

get_recent_sec_filings

SEC

Get recent SEC filings across all companies with AI-generated summaries.

pageint?Page number

limitint?Results per page

get_sec_filings_by_ticker

SEC

Get SEC filings for a specific company by ticker symbol.

tickerstringTicker symbol

pageint?Page number

limitint?Results per page

get_sec_filing_detail

SEC

Get full SEC filing detail including complete AI-generated summary and related filings.

accessionNumberstringSEC accession number

RSS Feeds

Standard RSS 2.0 feeds for integrating with feed readers, automation tools, and monitoring systems.

Feed	Endpoint	Description
All Articles	`/feed.xml`	Latest news articles across all categories
Category Articles	`/categories/{category}/feed.xml`	Articles filtered by category slug
Press Releases	`/stock/press-releases/feed.xml`	Latest press releases from all companies
SEC Filings	`/stock/sec-filings/feed.xml`	Recent SEC filings with AI summaries
Per-Stock Feed	`/stock/{TICKER}/feed.xml`	Combined press releases, filings, and articles for a stock

Integration Examples

Connect to the MCP server programmatically using the official MCP SDK.

Install: pip install mcp

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://caymanjournal.com/api/mcp") as (
        read_stream, write_stream, _
    ):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()

            # Get a stock quote
            result = await session.call_tool(
                "get_stock_quote",
                arguments={"symbol": "AAPL"}
            )
            print(result)

            # Search articles
            articles = await session.call_tool(
                "search_articles",
                arguments={"query": "technology", "limit": 5}
            )
            print(articles)