Check if server is alive.

AssemblyMCP를 처음 호출하는 LLM/클라이언트를 위한 공개 도구 표면과 워크플로 계약을 반환합니다.

기능:

• 검증/브리핑/타임라인/관계도/모니터링 중심의 권장 도구 경로 안내

• 공개 도구명 네이밍 규칙과 호환성 정책 설명

• [NOT_FOUND], [AMBIGUOUS], [VERIFY_FAILED], [API_FAILED], [PARTIAL] 실패 마커 의미 제공

전체 요약 + 필수 사용 가이드.

• 총 270여 개의 국회 OpenAPI를 모두 사용할 수 있습니다. 고수준 툴은 일부만 래핑하지만, list_api_services → get_api_spec → call_api_raw 조합으로 어떤 정보든 조회 가능합니다.

• "이 기능은 없다"라고 답하지 마세요. 고수준 툴에 없으면 서비스를 검색해 직접 호출하거나 연쇄 호출로 답을 구성하세요.

Returns basic server status plus 이 조합 워크플로우를 안내합니다.

특정 API 서비스의 상세 스펙을 조회합니다.

이 툴은 엔드포인트 URL, 요청 파라미터(타입/제약조건), 응답 구조 등 전체 API 명세를 반환합니다. 고수준 툴이 제공하지 않는 정보를 조회하기 위해 동적으로 API를 탐색할 때 유용합니다.

기능:

• 파라미터 제약조건 전체 반환.

• 데이터 미리보기(Data Preview): 실제 데이터 1건을 조회하여 값의 형식을 보여줍니다.

• 파라미터 힌트(Parameter Hints): 실제 데이터를 기반으로 유효한 입력값을 제안합니다 (예: UNIT_CD="22대").

워크플로우:

1. 'list_api_services(keyword)'로 서비스 ID 검색

2. 이 툴을 호출하여 파라미터 상세 확인

3. 'call_api_raw(service_id, params)'로 맞춤형 API 호출

Args: service_id: 서비스 ID (예: 'O4K6HM0012064I15889')

Returns: 파라미터와 엔드포인트를 포함한 전체 API 스펙

모든 OpenAPI(총 270여 개) 메타데이터를 검색합니다.

• 고수준 툴에 없다고 끝내지 말고, 여기서 서비스 ID를 찾은 뒤 get_api_spec → call_api_raw 로 직접 호출하세요.

• 키워드는 넓게 잡으세요. 국문/영문, 띄어쓰기/부분 문자열 모두 시도해볼 것.

Args: keyword: Keyword to search in service name or description.

Returns: List of services matching the keyword. Each item contains id, name, and description.

모든 국회 OpenAPI를 직접 호출하는 만능 백도어입니다.

• "해당 기능이 없다"는 답을 피하기 위해 항상 이 경로를 고려하세요.

• 절차: list_api_services로 ID 찾기 → get_api_spec로 파라미터 확인 → 여기서 호출.

• 응답을 받은 뒤, 필요한 경우 다른 고수준 툴(예: get_member_info, get_meeting_records)로 후속 검색을 연쇄 호출해 답을 완성하세요.

[주의] 이 툴은 입력값을 변환하지 않고 그대로 전송합니다.

• 특히 'UNIT_CD'(대수) 파라미터는 반드시 '1000xx' 형식을 사용해야 합니다. (예: 22대 국회 -> "100022", 21대 국회 -> "100021") 단순히 "22"라고 입력하면 데이터가 조회되지 않습니다.

Args: service_id: The ID of the service to call (e.g., 'OO1X9P001017YF13038'). params: JSON string of query parameters (e.g., '{"pSize": 5}').

Returns: Raw JSON response as a string.

의안을 검색하거나 목록을 조회합니다. (통합 검색 도구)

기능:

1. 키워드 검색: 'keyword'만 입력 (예: "인공지능")

2. 필터 검색: 'proposer'(발의자), 'bill_id', 'proc_status' 등 조합

3. 최신 목록: 파라미터 없이 호출하면 현재 대수의 최신 발의 의안 반환

4. 스마트 검색: 키워드 검색 시 현재 대수(22대) 결과가 없으면 이전 대수(21대) 자동 검색

Args: keyword: 검색어 (의안명). bill_id: 의안 고유 ID 또는 의안 번호. proposer: 제안자(의원명 등). age: 국회 대수 (기본 "22"). propose_dt: 제안일자 (YYYYMMDD). proc_status: 처리상태 코드. page: 페이지 번호 (기본 1). limit: 최대 결과 수 (기본 10).

Returns: 검색된 의안 목록. 결과가 없으면 MCP output schema 호환을 위해 빈 배열을 반환합니다.

특정 의안의 상세 정보를 조회합니다. 의안의 요약(MAJOR_CONTENT)과 제안 이유(PROPOSE_REASON)를 포함합니다.

사용법:

1. 'search_bills'로 의안 검색 후 'BILL_ID' 또는 'BILL_NO' 확인

2. 이 툴에 ID를 전달하여 상세 내용 조회

Args: bill_id: 의안 ID (예: 'PRC_...') 또는 의안 번호 (예: '2200001'). age: 선택적 대수 (예: "22").

Returns: 상세 정보가 포함된 의안 객체. 결과가 없으면 null을 반환합니다.

특정 의안의 발의부터 현재까지의 모든 주요 이력(회의 포함)을 날짜순으로 통합하여 조회합니다. 타임라인 생성이나 연혁 분석에 매우 유용합니다.

Args: bill_id: 의안 ID (예: 'PRC_...') 또는 의안 번호 (예: '2200001').

특정 주제(이슈)에 대한 종합적인 입법 현황 분석 리포트를 생성합니다. 이 도구는 관련 법안 검색, 주요 법안의 상세 내용, 관련 위원회 회의록, 그리고 해당 주제를 주도하는 주요 국회의원 정보를 한 번에 통합하여 제공합니다.

Args: topic: 분석할 입법 주제 또는 키워드 (예: "인공지능", "저출산"). limit: 검색할 관련 법안 수 (기본 5).

Returns: 종합 분석 리포트 데이터.

의안/의원/위원회/표결 주장 또는 인용을 국회 OpenAPI 데이터로 검증합니다.

입력 형식:

• JSON 배열: [{"type": "bill", "value": "간호법안"}, {"type": "member", "value": "홍길동"}]

• JSON 객체: {"type": "vote", "bill_id": "PRC_...", "expected": {"yes": 180}}

• 일반 텍스트: 자동으로 의안/의원/위원회 후보를 순차 확인합니다.

실패는 [NOT_FOUND], [AMBIGUOUS], [VERIFY_FAILED], [API_FAILED] 마커가 포함된 구조화 객체로 반환됩니다.

입법 주제에 대한 워크플로형 브리프를 생성합니다.

관련 의안, 소관 위원회, 회의 일정/기록, 국회 보고서/뉴스, 본회의 표결 신호를 조합하고 일부 하위 조회 실패는 [PARTIAL] 경고로 보존합니다.

특정 의안의 발의, 위원회 회부, 회의, 본회의 표결, 최종 처리 이벤트를 정규화된 타임라인으로 반환합니다.

기존 get_bill_history보다 event_type/source_tool/confidence 필드를 명시해 LLM이 후속 검증을 이어가기 쉽게 합니다.

주제 또는 의안을 중심으로 법안, 위원회, 의원, 보고서, 표결 신호의 관계 그래프를 생성합니다.

target_type은 auto/topic/bill을 지원합니다. 결과는 nodes, edges, mermaid, top_followups로 구성됩니다.

특정 입법 주제의 변화를 추적하기 위한 실행 계획과 다음 MCP 호출 목록을 생성합니다.

법률 자문이 아니라 국회 공개데이터 모니터링 절차를 반환합니다.

특정 주제나 법안과 관련된 국회 전문 보고서(NABO Focus 등) 및 뉴스를 조회합니다. 단순 법안 정보를 넘어 전문가의 분석 시각을 제공할 때 유용합니다.

Args: keyword: 검색 키워드 (예: "종합부동산세", "인공지능"). limit: 검색 결과 수 (기본 5).

특정 위원회의 현재 활동 현황(계류 의안, 관련 보고서 등)을 한 번에 조회합니다. 엔티티 간의 연관 데이터를 매핑하여 객관적인 정보를 제공합니다.

Args: committee_name: 위원회명 (예: "법제사법위원회", "환경노동위원회").

국회 API에서 공통으로 사용되는 코드값(대수, 처리상태 등) 가이드를 반환합니다. LLM이 call_api_raw를 호출하기 전 파라미터 값을 결정할 때 참고하세요.

국회의원 상세 정보를 검색합니다. 발의자가 누구인지, 소속 정당, 지역구 등을 파악할 때 유용합니다.

Args: name: 의원명 (예: "홍길동").

Returns: 국회의원 정보 목록.

위원회 회의 정보를 검색합니다.

Args: bill_id: 특정 의안과 관련된 회의를 찾을 때 사용 (예: '2100001'). committee_name: 위원회명 (예: "법제사법위원회"). date_start: 시작일 (YYYY-MM-DD). date_end: 종료일 (YYYY-MM-DD). page: 페이지 번호 (기본 1). limit: 최대 결과 수 (기본 10).

Returns: 회의록 및 일정 목록.

본회의 일정을 조회합니다. (Service ID: ORDPSW001070QH19059)

• unit_cd(대수) 파라미터가 중요합니다. (예: "22")

• 데이터가 없는 경우도 많으니 빈 결과가 나오면 대수를 변경하거나 생략해보세요.

Args: unit_cd: 대수 (예: "22"). 생략 시 전체 조회될 수 있음. page: Page number (default 1). limit: Max results (default 10).

위원회 목록을 조회하거나 특정 위원회의 상세 정보(위원 명단 포함)를 가져옵니다.

Args: committee_name: 위원회명 (예: "법제사법위원회"). committee_code: 위원회 코드 (HR_DEPT_CD). page: 페이지 번호 (기본 1). limit: 최대 결과 수 (기본 50).

Returns: 위원회 목록 또는 특정 위원회 상세 정보.

특정 국회의원의 종합 의정활동 리포트를 생성합니다. 인적사항, 최근 대표 발의 법안, 위원회 경력, 최근 본회의 투표 이력을 한 번에 제공합니다.

Args: member_name: 국회의원 성명 (예: "추경호").

특정 의안에 대한 본회의 표결 결과(찬성, 반대, 기권 수)와 정당별 투표 경향을 조회합니다.

Args: bill_id: 의안 ID (예: 'PRC_...').

특정 주제(키워드)와 관련된 법안들의 본회의 투표 경향을 분석합니다. 최근 관련 법안들의 가결 여부와 찬반 통계를 요약하여 제공합니다.

Args: topic: 분석할 주제 또는 키워드 (예: "종합부동산세", "간호법").

국회의원 개인의 본회의 표결 기록 또는 특정 의안의 개별 의원 표결 현황을 조회합니다.

Args: name: 의원 성명 (특정 의원의 이력을 볼 때 사용). bill_id: 의안 ID (특정 의안에 누가 어떻게 투표했는지 볼 때 사용). age: 국회 대수 (기본 "22"). page: 페이지 번호. limit: 결과 수 (최대 100).