AI 에이전트를 위한 FinancialMD
FinancialMD는 에이전트를 위한 AI 네이티브 금융 터미널입니다. SEC 공시 서류를 바탕으로 작성된 재무제표를 제공합니다. 모든 수치에는 공시 서류로 연결되는 근거가 있으며, 모든 조회는 과거 날짜를 기준으로 수행할 수 있습니다. 따라서 에이전트는 자신이 제시한 내용의 출처를 인용하고 미래 정보를 참조하지 않고 백테스트할 수 있습니다.
1단계. MCP 서버 연결
MCP 서버 주소는 https://mcp.financial.md/mcp입니다(Streamable HTTP, 무상태). 읽기 전용 도구 50개를 제공합니다. 로그인은 선택 사항이며, 토큰이 없어도 키 없는 일일 한도 내에서 응답합니다.
Claude Code:
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을 사용자 지정 커넥터로 추가하세요. 서버 카드는 mcp.financial.md/.well-known/mcp.json에, OAuth 메타데이터는 mcp.financial.md/.well-known/oauth-protected-resource에 있습니다.
company_lookup으로 시작한 다음, snapshot_as_of(해당 날짜에 알려진 3가지 재무제표와 비율을 한 번의 호출로 조회) 또는 financials_standardized를 사용하세요. 다른 곳에서 찾은 수치를 확인하려면 verify_value를 사용하세요.
2단계. 키 없이 API 호출
HTTP API는 계정도 키도 필요하지 않습니다. 이 호출은 잉여현금흐름을 포함한 Apple의 최근 5개 연간 현금흐름표를 반환합니다:
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의 공시 서류)을 포함하는 값 객체입니다. 해당 날짜에 알려진 정보를 조회하려면 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 주소에 하루 25회의 사용량 집계 대상 호출(비율, 스크리닝, 검증), 1,000회의 공시 서류 계층 조회, 1,000회의 메타데이터 조회가 허용됩니다. 모든 응답에는 RateLimit-* 헤더가 포함됩니다. 429 응답에는 Retry-After가 포함되며, 모든 오류 본문에는 해결 방법이 나열됩니다.
3단계. 호출별 결제
agent.financial.md는 계정 없이 x402(Base의 USDC)로 호출별 결제를 하는 에이전트에 동일한 경로를 제공합니다. 이 호스트의 유료 경로는 PAYMENT-REQUIRED 헤더에 가격을 담아 402로 응답합니다. 결제에 서명한 뒤 PAYMENT-SIGNATURE 헤더를 포함하여 다시 호출하세요. 402 본문에는 키 없이 사용할 수 있는 호스트도 명시되며, 해당 호스트에서는 일일 한도 내에서 같은 경로를 무료로 사용할 수 있습니다.
모든 경로의 가격은 pricing.json과 OpenAPI 문서의 x-price 필드에 있습니다. 실제로 적용되는 가격은 402 응답에 표시된 가격입니다. 실패한 호출에는 요금이 부과되지 않습니다.
에이전트용 파일
| 파일 | 설명 |
|---|---|
| openapi.json | OpenAPI 3.1. 모든 작업에 설명과 실제 티커를 사용하는 예제 요청 포함 |
| llms.txt | 간단한 가이드: 호스트, 회사 ID, 값 객체, 특정 시점 기준(point-in-time) 조회, 한도 |
| llms-full.txt | 모든 내용을 하나의 텍스트 파일로 제공: 모든 경로, 비율 계산식, 활용법 |
| skill.md | 한 번의 호출로 실행하는 활용법을 담은 에이전트 스킬 |
| skills.zip | MCP 도구를 호출하는 에이전트 스킬(SKILL.md)을 하나의 zip 파일로 제공 |
| pricing.json | 호출별 가격, 무료 한도, 결제 상태 |
| mcp.json | MCP 서버 카드: 도구, 인증, 문서 |
| server.json | MCP 레지스트리 항목 |
| agent.json | 위의 모든 엔드포인트와 문서를 모은 단일 색인 |
에이전트가 신뢰할 수 있는 것
- 모든 숫자에는 출처가 있습니다. 공시 서류의 접수번호, 서식, 공시 제출일, XBRL 태그와 sec.gov 문서 링크가 제공됩니다.
GET /proof/{id}는 해당 숫자의 근거가 되는 원시 데이터를 보여줍니다. - 특정 시점 기준(point-in-time):
known.from과known.to는 각 값이 언제 최신 공시 수치였는지 나타냅니다.as_of,original=true,history=true는 미래 정보를 참조하지 않고 과거 데이터를 조회하며 재작성 내역을 보여줍니다. - 간결한 응답: 재무제표 호출은 요청한 기간만 반환하며, MCP 도구 결과는 구조화된 데이터 앞에 한 줄 요약을 제공합니다.
- 티커, CIK 또는 이름:
company=ticker:AAPL,company=cik:320193또는GET /v1/companies?q=Apple. - 제공 범위: 현재 미국 거래소에 상장된 SEC 공시 제출 기업이며, US GAAP 공시 제출 기업에는 표준화된 재무제표를 제공합니다. 정보 제공만을 목적으로 하며, 투자 조언이 아닙니다.