SEC EDGAR MCP Server

SEC EDGAR MCP Server

Enables to search and retrieve SEC EDGAR filings, insider transactions, major shareholders, and executive compensation data through natural language.

Category
Visit Server

README

SEC EDGAR MCP 서버

로컬에서 압축 풀고 진행하는 순서

  1. 압축을 풀고 해당 폴더로 이동합니다.

    cd sec-edgar-mcp

  2. 패키지를 설치합니다.

    npm install

  3. (선택) 로컬 테스트를 하려면:

    npm run dev

    브라우저에서 http://localhost:3000 접속 확인.

  4. Vercel에 배포합니다.

    vercel --prod
    • 처음 실행하면 프로젝트 이름, 스코프 등을 물어봅니다. 기본값(Enter)으로 진행하면 됩니다.
    • 배포가 끝나면 https://sec-edgar-mcp-xxxx.vercel.app 같은 URL이 출력됩니다.

  5. 환경변수 설정 (필수)

    • https://vercel.com 대시보드 → 방금 배포된 프로젝트 → Settings → Environment Variables
    • SEC_USER_AGENT = 포니링크 IT사업본부 실제이메일주소@ponylink.com 형태로 등록 (SEC는 User-Agent에 회사명+이메일이 없으면 요청을 차단합니다)
    • 저장 후 재배포: vercel --prod 다시 한 번 실행

  6. claude.ai에 등록

    • claude.ai 설정 > 커넥터 > 사용자 지정 커넥터 추가
    • URL: https://[배포된 주소]/mcp

제공되는 도구 8개

  • search_company: 회사명/티커로 CIK 검색
  • get_company_filings: CIK로 최근 공시 목록(10-K, 10-Q, 8-K, 20-F 등) 조회
  • get_company_facts: CIK로 XBRL 재무데이터(매출, 순이익 등) 조회
  • get_filing_section: 10-K/20-F/8-K 원문에서 특정 섹션(지분구조, 위험요소 등)만 추출. keyword 없이 호출하면 문서 목차(Item 목록)를 먼저 보여줍니다.
  • get_insider_transactions: Form 4(임원·주요주주 지분변동보고) 구조화 조회 (거래일, 거래유형, 수량, 단가, 거래후 보유량)
  • full_text_search: 키워드로 SEC 전체 공시 통합검색 (DART 공시검색과 유사, 회사명 없이도 검색 가능)
  • get_major_shareholders: 13D/13G(5% 이상 주요주주 보고) 목록 및 표지 원문 발췌 조회
  • get_executive_compensation: 최근 DEF 14A(주주총회소집통지)에서 임원보수 섹션 원문 추출

get_filing_section 사용 팁

  1. 먼저 keyword 없이 호출해서 목차를 확인: get_filing_section(url=..., keyword 생략)
  2. 목차에서 원하는 항목명을 keyword로 넣어 재호출 예) 20-F의 지분구조 → keyword: "Share Ownership" 예) 10-K의 위험요소 → keyword: "Risk Factors"

참고

  • SEC data.sec.gov API는 인증키가 필요 없습니다.
  • 요청 빈도 제한: 초당 10회 권장 (SEC 공식 가이드라인)

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured