FinancialMD dla agentów AI
FinancialMD to terminal finansowy dla agentów, stworzony z myślą o AI. Udostępnia sprawozdania finansowe zbudowane na podstawie zgłoszeń w SEC. Każda liczba zawiera dowód prowadzący z powrotem do zgłoszenia, a każdy odczyt można wykonać według stanu na datę z przeszłości, dzięki czemu agent może cytować to, co mówi, i przeprowadzać backtesty bez look-ahead.
Krok 1. Podłącz serwer MCP
Serwer MCP jest dostępny pod adresem https://mcp.financial.md/mcp (Streamable HTTP, bezstanowy). Ma 57 narzędzia tylko do odczytu. Logowanie jest opcjonalne: bez tokena odpowiada w ramach dziennych limitów bez klucza.
Claude Code:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpKlienci, którzy odczytują konfigurację JSON (Cursor, VS Code, Windsurf i inne):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}W Claude lub ChatGPT dodaj ten sam URL jako niestandardowy konektor. Karta serwera jest pod adresem mcp.financial.md/.well-known/mcp.json, a metadane OAuth pod mcp.financial.md/.well-known/oauth-protected-resource.
Zacznij od company_lookup, potem snapshot_as_of (wszystkie trzy sprawozdania i wskaźniki znane na dany dzień, w jednym wywołaniu) lub financials_standardized. Użyj verify_value, aby sprawdzić liczbę, którą znalazłeś gdzie indziej.
Krok 2. Wykonaj wywołanie API bez klucza
HTTP API nie wymaga konta ani klucza. To wywołanie zwraca pięć ostatnich rocznych rachunków przepływów pieniężnych Apple, w tym wolne przepływy pieniężne:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"Każda liczba jest obiektem wartości z proof.accession, proof.form, proof.filed i proof.source_url (zgłoszenie na sec.gov). Dodaj as_of=2024-06-30, aby odczytać to, co było znane na ten dzień. Sprawdź liczbę względem zgłoszenia:
curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
-d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'Bez klucza każdy adres IP otrzymuje 10 limitowanych wywołań dziennie (ratios, screen, verify), 1,000 odczytów warstwy zgłoszeń i 1,000 odczytów metadanych. Każda odpowiedź zawiera nagłówki RateLimit-*; odpowiedź 429 zawiera Retry-After, a treść każdego błędu zawiera listę możliwych rozwiązań.
Krok 3. Płatność za wywołanie
agent.financial.md obsługuje te same trasy dla agentów, którzy płacą za wywołanie przez x402 (USDC na Base), bez konta. Trasa z ceną odpowiada kodem 402 z ceną w nagłówku PAYMENT-REQUIRED; podpisz płatność i wyślij wywołanie ponownie z nagłówkiem PAYMENT-SIGNATURE. Treść odpowiedzi 402 podaje też host bez klucza, gdzie ta sama trasa nigdy nie jest płatna w ramach limitów dziennych.
Cena każdej trasy jest w pricing.json oraz w polu x-price w dokumencie OpenAPI. Cena w odpowiedzi 402 jest wiążąca. Nieudane wywołanie nie jest naliczane.
Pliki dla agentów
| Plik | Co to jest |
|---|---|
| openapi.json | OpenAPI 3.1. Każda operacja ma opis i przykładowe żądanie z prawdziwym tickerem |
| llms.txt | Krótki przewodnik: hosty, identyfikatory spółek, obiekt wartości, odczyty na określony dzień (point-in-time), limity |
| llms-full.txt | Wszystko w jednym pliku tekstowym: każda trasa, formuła wskaźnika i instrukcja |
| skill.md | Agent Skill z instrukcjami dla pojedynczego wywołania |
| skills.zip | Agent Skills (SKILL.md), które wywołują narzędzia MCP, w jednym pliku zip |
| pricing.json | Ceny za wywołanie, limity dzienne i status płatności |
| mcp.json | Karta serwera MCP: narzędzia, uwierzytelnianie i dokumenty |
| server.json | Wpis w rejestrze MCP |
| agent.json | Jeden indeks wszystkich powyższych endpointów i dokumentów |
Na czym agent może polegać
- Każda liczba ma źródło: numer akcesyjny zgłoszenia, formularz, datę złożenia, tag XBRL i link do dokumentu na sec.gov.
GET /proof/{id}pokazuje surowe fakty, które za nią stoją. - Na określony dzień (point-in-time):
known.fromiknown.topokazują, kiedy każda wartość była najnowszą zgłoszoną liczbą.as_of,original=trueihistory=trueodczytują przeszłość bez look-ahead i pokazują wartości przekształcone. - Krótkie odpowiedzi: wywołanie sprawozdania zwraca tylko żądane okresy; wyniki narzędzi MCP zaczynają się od jednolinijkowego podsumowania przed danymi strukturalnymi.
- Ticker, CIK lub nazwa:
company=ticker:AAPL,company=cik:320193, lubGET /v1/companies?q=Apple. - Zakres: podmioty składające dokumenty do SEC, dziś notowane na giełdzie w US; ujednolicone sprawozdania dla podmiotów raportujących według US GAAP. Tylko informacje, nie porada inwestycyjna.