AI ఏజెంట్ల కొరకు FinancialMD
FinancialMD ఏజెంట్ల కోసం AI-native ఆర్థిక టెర్మినల్. ఇది SEC ఫైలింగ్స్ నుంచి రూపొందించిన ఆర్థిక స్టేట్మెంట్లను అందిస్తుంది. ప్రతి సంఖ్య ఫైలింగ్కు తిరిగి వెళ్లే రుజువును కలిగి ఉంటుంది, మరియు ప్రతి రీడ్ను గత తేదీ నాటికి చేయవచ్చు, కాబట్టి ఏజెంట్ తాను చెప్పినదాన్ని ఉదహరించగలదు మరియు look-ahead లేకుండా backtest చేయగలదు.
దశ 1. MCP సర్వర్ ను కనెక్ట్ చేయండి
MCP సర్వర్ https://mcp.financial.md/mcp వద్ద ఉంది (Streamable HTTP, stateless). దీనిలో 57 రీడ్-ఓన్లీ టూల్స్ ఉన్నాయి. సైన్ ఇన్ చేయడం ఐచ్ఛికం: టోకెన్ లేకుండా ఇది keyless రోజువారీ పరిమితులలో సమాధానం ఇస్తుంది.
క్లాడ్ కోడ్:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpJSON కాన్ఫిగ్ చదివే క్లయింట్లు (Cursor, VS Code, Windsurf మరియు ఇతరాలు):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}Claude లేదా ChatGPT లో, అదే URL ను custom connector గా జోడించండి. సర్వర్ కార్డ్ mcp.financial.md/.well-known/mcp.json వద్ద ఉంది, మరియు OAuth metadata mcp.financial.md/.well-known/oauth-protected-resource వద్ద ఉంది.
company_lookup తో ప్రారంభించండి, తర్వాత snapshot_as_of (ఒకే కాల్లో, ఒక తేదీ నాటికి తెలిసిన మూడు స్టేట్మెంట్లు మరియు నిష్పత్తులు) లేదా financials_standardized. మీరు వేరే చోట కనుగొన్న సంఖ్యను తనిఖీ చేయడానికి verify_value ఉపయోగించండి.
దశ 2. కీలెస్ API కాల్ చేయండి
HTTP APIకి ఖాతా లేదా కీ అవసరం లేదు. ఈ కాల్ Apple యొక్క చివరి ఐదు వార్షిక నగదు ప్రవాహ నివేదికలను, ఫ్రీ క్యాష్ ఫ్లోతో సహా, తిరిగి ఇస్తుంది:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"ప్రతి సంఖ్య proof.accession, proof.form, proof.filed మరియు proof.source_url (sec.govలోని ఫైలింగ్) కలిగిన ఒక value object గా ఉంటుంది. ఆ తేదీన తెలిసిన సమాచారాన్ని చదవడానికి as_of=2024-06-30 జోడించండి. ఒక సంఖ్యను ఫైలింగ్తో సరిపోల్చి తనిఖీ చేయండి:
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}'కీ లేకుండా, ప్రతి IP చిరునామాకు రోజుకు 10 మీటర్ చేసిన కాల్స్ (ratios, screen, verify), 1,000 ఫైలింగ్-లేయర్ రీడ్లు మరియు 1,000 మెటాడేటా రీడ్లు లభిస్తాయి. ప్రతి ప్రతిస్పందనలో RateLimit-* హెడర్లు ఉంటాయి; 429లో Retry-After ఉంటుంది, మరియు ప్రతి లోప బాడీలో పరిష్కారాలు జాబితా చేయబడతాయి.
దశ 3. ప్రతి కాల్కు చెల్లించండి
agent.financial.md ఖాతా లేకుండా x402 (Base పై USDC) తో ప్రతి కాల్కు చెల్లించే ఏజెంట్ల కోసం అదే మార్గాలను అందిస్తుంది. అక్కడ ధర ఉన్న మార్గం 402తో PAYMENT-REQUIRED హెడర్లో ధరను పంపుతుంది; చెల్లింపుపై సంతకం చేసి, PAYMENT-SIGNATURE హెడర్తో కాల్ను మళ్లీ పంపండి. 402 యొక్క బాడీలో కీలెస్ హోస్ట్ పేరు కూడా ఉంటుంది, అక్కడ అదే మార్గం రోజువారీ పరిమితులలో ఎప్పుడూ రుసుము వసూలు చేయబడదు.
ప్రతి మార్గం యొక్క ధర pricing.json లోను, OpenAPI document లోని x-price ఫీల్డ్లోను ఉంటుంది. 402 సమాధానంలోని ధరే వర్తిస్తుంది. విఫలమైన కాల్కు ఛార్జ్ చేయబడదు.
ఏజెంట్ల కోసం ఫైళ్లు
| ఫైలు | అది ఏమిటి |
|---|---|
| openapi.json | OpenAPI 3.1. ప్రతి ఆపరేషన్ కు నిజమైన టిక్కర్ తో వివరణ మరియు ఉదాహరణ అభ్యర్థన ఉంటుంది |
| llms.txt | సంక్షిప్త గైడ్: హోస్టులు, కంపెనీ ఐడీలు, వాల్యూ ఆబ్జెక్ట్, పాయింట్-ఇన్-టైమ్ రీడ్లు, పరిమితులు |
| llms-full.txt | ఒక టెక్స్ట్ ఫైల్లో అన్నీ: ప్రతి మార్గం, నిష్పత్తి సూత్రం మరియు రెసిపీ |
| skill.md | ఒక-కాల్ రెసిపీలతో ఏజెంట్ స్కిల్ |
| skills.zip | MCP టూల్స్ను పిలిచే ఏజెంట్ స్కిల్స్ (SKILL.md), ఒక zip గా |
| pricing.json | ప్రతి-కాల్ ధరలు, రోజువారీ పరిమితులు మరియు చెల్లింపు స్థితి |
| mcp.json | MCP సర్వర్ కార్డ్: సాధనాలు, ప్రామాణీకరణ మరియు పత్రాలు |
| server.json | MCP రిజిస్ట్రీ ఎంట్రీ |
| agent.json | పైన ఉన్న ప్రతి ఎండ్పాయింట్ మరియు డాక్యుమెంట్కు ఒక ఇండెక్స్ |
ఒక ఏజెంట్ దేనిపై ఆధారపడగలడు
- ప్రతి సంఖ్యకు ఒక మూలం ఉంటుంది: ఫైలింగ్ యొక్క accession number, form, filing date, XBRL tag మరియు sec.gov లోని డాక్యుమెంట్కు లింక్.
GET /proof/{id}దాని వెనుక ఉన్న raw facts ను చూపిస్తుంది. - పాయింట్-ఇన్-టైమ్:
known.fromమరియుknown.toప్రతి విలువ ఎప్పుడు తాజా ఫైల్ చేసిన సంఖ్యగా ఉన్నదో చెబుతాయి.as_of,original=trueమరియుhistory=trueముందుచూపు లేకుండా గతాన్ని చదివి పునఃప్రకటనలను చూపుతాయి. - సంక్షిప్త సమాధానాలు: ఒక statement call అడిగిన కాలాలను మాత్రమే తిరిగి ఇస్తుంది; MCP టూల్ ఫలితాలు నిర్మాణాత్మక డేటాకు ముందు ఒక-లైన్ సారాంశంతో ప్రారంభమవుతాయి.
- టిక్కర్, CIK లేదా పేరు:
company=ticker:AAPL,company=cik:320193, లేదాGET /v1/companies?q=Apple. - కవరేజ్: ఈ రోజు US ఎక్స్చేంజ్లో జాబితా చేయబడిన SEC ఫైలర్లు; US GAAP ఫైలర్ల కోసం ప్రామాణిక statements. సమాచారం మాత్రమే, పెట్టుబడి సలహా కాదు.