MyFSS

MyFSS MCP의 search_documents 도구는 금융감독원(FSS)·금융위원회(FSC) 회계·공시 자료를 전문검색합니다. [Purpose] - What 감독당국 checks — 심사·감리 지적사례·감독지침·모범사례 등 게시판 11종. - Filters alone (no query) sweep a topic. [Usage] 1. "전환사채 콜옵션 관련 감독원 자료" → query="전환사채 콜옵션" 2. "작년 감리 지적사례 전부" → board="sanction_case", date_from="2025-01-01", date_to="2025-12-31" 3. "내부회계관리제도 주제로 20건" → topics=["내부회계관리제도"], limit=20 [Response] - { total, showing, offset, note, results:[{ntt_id, date, board, source, title, nature, topics, depts, summary, url, snippet?}] } - total = 전체 건수, showing = 이번 페이지 — paginate with offset. - source: "fss"=금융감독원, "fsc"=금융위원회. - snippet marks matches with [ … ]; only when a query matched. [Rules] - board is asymmetric: param = English key, response = 한글 라벨 — never feed it back. - topics·depts are joined strings (", " / " / "), not arrays — split first. - ≥3-char tokens → FTS (AND, rank); 1~2-char → LIKE. No query → 게시일 DESC, no snippet. - Corpus = 2010 onward (absent = 미수록); quote body via get_document, not summary·snippet.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "검색 키워드 (공백 구분, 예: '전환사채 콜옵션')",
      "type": "string"
    },
    "topics": {
      "description": "주제 태그 필터 (하나라도 일치, list_tags의 topics 값)",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "nature": {
      "description": "문서 성격 필터",
      "type": "string",
      "enum": [
        "감리·조사결과",
        "제도개정",
        "지침·모범사례",
        "실태·통계",
        "행사·안내",
        "기타"
      ]
    },
    "board": {
      "description": "게시판 필터",
      "type": "string",
      "enum": [
        "press",
        "guidance",
        "modelnotes",
        "manual",
        "trend",
        "extaudit",
        "icfr",
        "education",
        "sanction_case",
        "sanction_corp",
        "fsc_press"
      ]
    },
    "source": {
      "description": "발행기관 필터 (fss=금융감독원, fsc=금융위원회)",
      "type": "string",
      "enum": [
        "fss",
        "fsc"
      ]
    },
    "dept": {
      "description": "담당부서명 부분일치 (예: '회계감리')",
      "type": "string"
    },
    "date_from": {
      "description": "YYYY-MM-DD 이후",
      "type": "string"
    },
    "date_to": {
      "description": "YYYY-MM-DD 이전",
      "type": "string"
    },
    "limit": {
      "default": 15,
      "description": "최대 결과 수 (기본 15)",
      "type": "number"
    },
    "offset": {
      "default": 0,
      "description": "페이지네이션 오프셋",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MyFSS MCP의 get_document 도구는 문서 전문을 반환합니다 — 첨부 HWP를 마크다운으로 변환한 본문. [Purpose] - To read and quote a found document — summary·snippet are never quoting grounds. [Usage] 1. "그 자료 본문 보여줘" → ntt_id=12345 2. "길어서 잘렸는데 이어서" → ntt_id=12345, offset_chars=60000 3. "앞부분만 짧게" → ntt_id=12345, max_chars=8000 [Response] - { ntt_id, date, board, source, title, nature, topics, depts, summary, url, attachments:[{file_name, ext, parsed}], body_total_chars, offset_chars, truncated, body } - truncated=true means offset_chars+max_chars < body_total_chars — raise offset_chars to continue. - Unknown id returns { error: "ntt_id {n} 없음" }. - body = "(본문 없음)" when nothing was parsed and no HTML 본문 exists. [Rules] - body = parsed attachments (parsed=true) joined under "## 첨부: {file_name}" heads; with no attachment body it falls back to the detail-page HTML body (mostly FSC). - attachments with parsed=false are NOT in body — disclose the gap, never hide it. - Continue with offset_chars; raising max_chars grows the whole response.

{
  "type": "object",
  "properties": {
    "ntt_id": {
      "type": "number",
      "description": "search_documents/list_recent가 반환한 ntt_id"
    },
    "max_chars": {
      "default": 60000,
      "description": "본문 최대 길이(자)",
      "type": "number"
    },
    "offset_chars": {
      "default": 0,
      "description": "본문 시작 오프셋 (긴 문서 이어읽기)",
      "type": "number"
    }
  },
  "required": [
    "ntt_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MyFSS MCP의 list_recent 도구는 최신 문서 목록을 게시일 내림차순으로 반환합니다. [Purpose] - Query-less skim of "what came out lately", optionally narrowed by 게시판. [Usage] 1. "최근 자료 뭐 있어" → (인자 없음 — limit=20) 2. "감리 지적사례 최신 10건" → board="sanction_case", limit=10 3. "금융위 보도자료 최신" → board="fsc_press" [Response] - { results:[{ntt_id, date, board, source, title, nature, topics, depts, summary, url}] } - No total/offset — this tool has no pagination, and no snippet (there is no query). [Rules] - board takes the English key while the response returns the 한글 라벨 — same asymmetry as search_documents; never feed the response board back as a parameter. - Sorted by 게시일(date) — retroactively registered old documents never surface as new. - For period/topic narrowing or larger volumes use search_documents.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "최대 결과 수 (기본 20)",
      "type": "number"
    },
    "board": {
      "description": "게시판 필터",
      "type": "string",
      "enum": [
        "press",
        "guidance",
        "modelnotes",
        "manual",
        "trend",
        "extaudit",
        "icfr",
        "education",
        "sanction_case",
        "sanction_corp",
        "fsc_press"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MyFSS MCP의 list_tags 도구는 검색 필터에 넣을 수 있는 어휘를 반환합니다 — 주제 태그·문서 성격·게시판·주요 담당부서. [Purpose] - Which values actually exist for search_documents' topics·nature·board·dept. Invented values return 0 rows, not an error — check here before a futile search. [Usage] 1. "어떤 주제로 검색할 수 있어?" → (인자 없음) [Response] - { topics:[{name, n}], natures:[{name, n}], boards:[{key, label, n}], depts_top25:[{name, n}] } - n = 그 값이 붙은 문서 수. - boards[].key is what the board parameter takes; boards[].label is what responses show. [Rules] - topics is exact-match — no partial/synonym matching; pass a name from here verbatim. - dept is the opposite, partial match — a fragment like "회계감리" works. - depts_top25 is only the top 25 — a 부서 missing from the list still exists.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MyFSS MCP의 get_usage_stats 도구는 이 MCP 서버의 도구 사용량 통계를 반환합니다. [Purpose] - Per-tool usage·latency (avg/percentiles)·error rate·daily trend. [Usage] 1. "최근 30일 사용량" → (인자 없음) 2. "지난 7일만" → days=7 3. "전체 기간" → days=0 [Response] - Both tiers: { visibility, period:{days, since, until}, overview:{total_calls, unique_users, errors, error_rate, p50_ms, p90_ms, p99_ms}, by_tool:[{tool, calls, errors, error_rate, avg_ms, p99_ms, users}], by_day:[{day, calls}] } - visibility="public" adds `note`; period.days = "all" when days=0. - visibility="operator" adds users:[{user, is_owner, calls, distinct_tools, first_seen, last_seen, tools:[{tool, calls, avg_ms}]}] and top_targets:[{target, tool, calls, users}]. [Rules] - Tier by requester: admin token·local stdio → "operator", else "public". - users·top_targets exist only at operator tier — absence ≠ 0. - `user` is a truncated SHA-256 of the 접속 토큰 — not a person. stdio calls (no hash) never appear. - Timings = server-side handler time (no network).

{
  "type": "object",
  "properties": {
    "days": {
      "default": 30,
      "description": "최근 N일 윈도 (0이면 전체 기간, 기본 30)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}