Ship financial AI without building SEC retrieval.

1# Illustrative — Claude + AlphaCreek MCP (Streamable HTTP).
2# Runnable script: project_ff/alphacreek_mcp/examples/python_anthropic.py — docs: /docs#python-anthropic-example
3
4import asyncio
5import functools
6import mcp.types as T
7from anthropic import Anthropic
8from mcp import ClientSession
9from mcp.client.streamable_http import streamablehttp_client
10
11MCP_URL = "https://mcp.alphacreek.ai/mcp"
12HEADERS = {"Authorization": "Bearer <ALPHACREEK_API_KEY>"}
13QUESTION = "What are NVIDIA's biggest risks in the latest 10-K?"
14
15async def ask_with_filing_tools() -> None:
16    ac = Anthropic(api_key="<ANTHROPIC_API_KEY>")
17    async with streamablehttp_client(MCP_URL, headers=HEADERS, timeout=120, sse_read_timeout=300, terminate_on_close=True) as (read, write, _):
18        async with ClientSession(read, write, client_info=T.Implementation(name="demo", version="0")) as session:
19            await session.initialize()
20            listed = await session.list_tools()
21            atools = [
22                {
23                    "name": t.name,
24                    "description": ((t.description or "").strip() or "(MCP tool)"),
25                    "input_schema": t.inputSchema if isinstance(t.inputSchema, dict) else {"type": "object", "properties": {}},
26                }
27                for t in listed.tools
28            ]
29            messages = [{"role": "user", "content": QUESTION}]
30            call = functools.partial(
31                ac.messages.create,
32                model="claude-sonnet-4-6",
33                max_tokens=8192,
34                system="Answer using only AlphaCreek filing tools; ground claims in tool output.",
35                messages=messages,
36                tools=atools,
37                tool_choice={"type": "auto"},
38            )
39            resp = await asyncio.to_thread(call)
40            # If stop_reason is tool_use: await session.call_tool(...), append assistant + user tool_result
41            # blocks to messages, then messages.create again until end_turn (see /docs).
42