Youth Policy Navigator
A FastMCP server that searches Korean youth policies and deterministically judges user eligibility, driving a missing-info follow-up loop with user memory.
Search youth policies: free-text, region, and category search over a built-in corpus and the Youth Center API.
Check eligibility: returns eligible / ineligible / needs_more_info / manual_review with per-condition reasons and missing-info questions.
Get policy details: application period, method, required documents, official URL, and agency.
Remember user profile: stores durable user facts (age, region, income, employment, etc.) for later use.
Recall user profile: retrieves relevant saved user context to personalize searches and eligibility checks.
Find youth centers: locates nearby Korean youth centers for offline, in-person application help.
๐งญ Youth Policy Navigator
์ฒญ๋ ์ ์ฑ ๊ฒ์ยท์๊ฒฉ ํ์ ์ ์ํ MCP Server
Search โ Eligibility Check โ Missing Info โ Memory โ Re-evaluation
Kakao PlayMCP ๊ณต๋ชจ์ ํ๋ก์ ํธ
์ฒญ๋ ์ ์ฑ ยท์ง์๊ธ์ ๋จ์ ๊ฒ์ํ๋ ๋ฐ์ ๋๋์ง ์๊ณ , ์ฌ์ฉ์์ ์ํฉ๊ณผ ์ ์ฑ ์กฐ๊ฑด์ ๋น๊ตํด ์ ๊ฒฉ / ๋ถ์ ๊ฒฉ / ์ ๋ณด๋ถ์กฑ์ ์ด์ ์ ํจ๊ป ํ์ ํ๋ MCP ์๋ฒ์ ๋๋ค.
Why this project?
Feature | What it does |
๐ Hybrid Search | ์จํต์ฒญ๋ API + ๋ด์ฅ corpus๋ฅผ Contextual BM25๋ก ๊ฒ์ |
โ Deterministic Eligibility | ๋์ดยท์ง์ญยท์๋ยท์ทจ์ ์ํ๋ฅผ ๊ตฌ์กฐํ ์กฐ๊ฑด์ผ๋ก ํ์ |
โ Missing-info Loop | ์ ๋ณด๊ฐ ๋ถ์กฑํ๋ฉด ๋ค์ ์ง๋ฌธ์ ๋ง๋ค์ด host LLM์ด ๋๋ฌป๊ฒ ํจ |
๐ง User Memory | SQLite์ ์ฌ์ฉ์ ์ํฉ์ ์ ์ฅํ๊ณ ํ์ํ ์ ๋ณด๋ฅผ ํ์ |
๐งฉ MCP Tools | ์์ฐ์ด ์์ฑ์ host LLM, ๋ฐ์ดํฐยทํ์ ์ server๊ฐ ๋ด๋น |
Related MCP server: gov-support-mcp
Agent Loop
flowchart LR
U[User Query] --> S[Policy Search]
S --> E[Eligibility Check]
E -->|Enough info| R[Reasoned Result]
E -->|Missing info| Q[Follow-up Question]
Q --> M[Remember Profile]
M --> E์๋ฒ๊ฐ โ๋ต๋ณ ๋ฌธ์ฅโ์ ๋ง์๋๋ก ์์ฑํ์ง ์๊ณ , ๊ทผ๊ฑฐ ๋ฐ์ดํฐ์ ๊ฒฐ์ ๋ก ์ ํ์ ๊ฒฐ๊ณผ๋ฅผ ์ ๊ณตํ๋๋ก ์ญํ ์ ๋ถ๋ฆฌํ ๊ฒ์ด ํต์ฌ์ ๋๋ค.
MCP Tools
Tool | Role |
| ์ ์ฑ ๊ฒ์ |
| ์ฌ์ฉ์ ์กฐ๊ฑด ๊ธฐ๋ฐ ์๊ฒฉ ํ์ |
| ์ ์ฒญ ๋ฐฉ๋ฒยท๊ธฐ๊ฐยท์๋ฅยทURL |
| ์ฌ์ฉ์ ์ํฉ ์ ์ฅ |
| ๊ด๋ จ ์ฌ์ฉ์ ์ ๋ณด ํ์ |
Example
โ์์ธ ์ง์ ์ ์ฑ ์ฐพ์์คโ โ ๊ด๋ จ ์ ์ฑ ๊ฒ์
์๊ฒฉ ํ์ ์ ์๋ ์ ๋ณด๊ฐ ๋ถ์กฑํจ โ
needs_more_infohost LLM์ด ์๋ ์ ๋ณด๋ฅผ ์ง๋ฌธ
๋ต๋ณ์ memory์ ์ ์ฅ
๋์ผ ์ ์ฑ ์ ๋ค์ ํ์ โ
eligible / ineligible / manual_review
Quick Start
uv sync --extra dev
uv run pytest -q
# local stdio
uv run policy-mcp
# remote HTTP
MCP_TRANSPORT=http uv run policy-mcpDocker:
docker build --platform linux/amd64 -t policy-mcp .API key๊ฐ ์์ด๋ ๋ด์ฅ corpus ๊ธฐ๋ฐ mock์ผ๋ก ๋์ํฉ๋๋ค.
.env์ ๋ฐ๊ธ๋ฐ์ ์ ์ฑ
API ํค๋ฅผ ์ค์ ํฉ๋๋ค.
YOUTHCENTER_API_KEY_POLICY=your_api_key2026-07 ๊ธฐ์ค ์ ๊ท API ๊ท๊ฒฉ์ ์ค์ ๋ฐ๊ธํค๋ก ๊ฒ์ฆํ์ต๋๋ค. ์ ์ฑ ์กฐ๊ฑด์ ๊ณต๊ณ ์ ๋ฐ๋ผ ๋ณ๋๋ ์ ์์ผ๋ฏ๋ก ์ต์ข ์ ์ฒญ ์ ์๋ฌธ ๊ณต๊ณ ํ์ธ์ด ํ์ํฉ๋๋ค.
Project Structure
src/policy_mcp/
โโโ server.py # FastMCP server / tools
โโโ policies.py # search service
โโโ eligibility.py # deterministic eligibility engine
โโโ policy_corpus.py # built-in policy corpus
โโโ memory.py # SQLite + BM25 memory
โโโ retrieval.py # Contextual BM25
โโโ clients/ # Youth Center API client
tests/ # 48 offline testsDesign Principle
LLM์ ํด์๊ณผ ๋ํ๋ฅผ ๋ด๋นํ๊ณ , eligibility decision์ ์ฌํ ๊ฐ๋ฅํ ์ฝ๋๊ฐ ๋ด๋นํ๋ค.
์ด ๊ตฌ์กฐ๋ฅผ ํตํด ์ ์ฑ ๊ฒ์ ๊ฒฐ๊ณผ๊ฐ ๋ฐ๋๋๋ผ๋ ์๊ฒฉ ํ์ ๊ณผ์ ๊ณผ ๊ทผ๊ฑฐ๋ฅผ ์ถ์ ํ๊ธฐ ์ฝ๊ฒ ๋ง๋ค์์ต๋๋ค.
Available Tools
6 toolscheck_eligibilityCheck policy eligibilityARead-onlyIdempotent
Youth Policy Navigator(์ฒญ๋ ์ ์ฑ ๋ด๋น๊ฒ์ดํฐ): the KILLER feature โ deterministically judge whether a user is eligible for a specific policy (by policy_id). Provide the user's situation either inline via profile (age, region, annual_income, income_band, employment_status, education, marital_status โ all optional) or via user_key to restore a remembered profile. Returns a verdict (eligible / ineligible / needs_more_info / manual_review) with per-condition checks, fail reasons, and โ crucially โ missing_info questions to ASK the user next when data is insufficient. Use those questions to drive a follow-up loop: ask, save with remember_user_profile, then re-run this. Free-text conditions are returned as manual for you to confirm against the notice.
Inputs: policy_id (required), profile, user_key. Returns: object
find_youth_centersFind youth centersARead-onlyIdempotent
Youth Policy Navigator(์ฒญ๋ ์ ์ฑ ๋ด๋น๊ฒ์ดํฐ): find nearby Korean youth centers (์ฒญ๋ ์ผํฐ/์ฒญ๋ ๊ณต๊ฐ) for offline, in-person help โ connecting a user to a local place where staff can walk them through applications and documents AFTER policies are matched. Filter by region (์๋/์๊ตฐ๊ตฌ name, e.g. '์์ธ', '๊ฒฝ๊ธฐ ์์') and/or a free-text keyword (center name or area). Returns each center's name, address, phone, homepage URL, and ์๋/์๊ตฐ๊ตฌ. Backed by the ์จํต์ฒญ๋ (Youth Center) getSpace open API (about 678 centers nationwide) when a key is configured; region and keyword filtering are applied client-side. Call this once the user wants face-to-face guidance or asks where they can get help near them.
Inputs: limit, region, keyword. Returns: object
get_policy_detailGet policy detailARead-onlyIdempotent
Youth Policy Navigator(์ฒญ๋ ์ ์ฑ ๋ด๋น๊ฒ์ดํฐ): return full application details for a specific policy (by policy_id) โ support content, application period, how to apply, required documents, official apply URL, supervising agency, and an eligibility summary with source and as-of date. Call this after the user picks a policy from search_youth_policies and wants to know how and when to apply, or what documents are needed.
Inputs: policy_id (required). Returns: object
recall_user_profileRecall user profileARead-onlyIdempotent
Youth Policy Navigator(์ฒญ๋ ์ ์ฑ ๋ด๋น๊ฒ์ดํฐ): recall a user's previously saved situation/preferences relevant to a query, via contextual retrieval. Pass the same user_key used when saving. Call this before recommending policies or judging eligibility to personalize; an empty query returns the most recent notes.
Inputs: user_key (required), k, query. Returns: object
remember_user_profileRemember user profileA
Youth Policy Navigator(์ฒญ๋ ์ ์ฑ ๋ด๋น๊ฒ์ดํฐ): remember a user's situation or preference for later personalization and eligibility judging (e.g. '๋์ด 27', '์์ธ ๊ฑฐ์ฃผ', '์ฐ์๋ 2800๋ง์', '๊ตฌ์ง ์ค', '๋ํ ์กธ์ '). Pass a stable per-user identifier as user_key that YOU control, and a short note. Call this whenever the user reveals a durable fact about their age, region, income, employment or education, so a later check_eligibility can restore and use it.
Inputs: note (required), user_key (required). Returns: object
search_youth_policiesSearch youth policiesARead-onlyIdempotent
Youth Policy Navigator(์ฒญ๋ ์ ์ฑ ๋ด๋น๊ฒ์ดํฐ): search Korean youth policies and subsidies (housing rent support, asset-building savings, job-seeker allowances, transit discounts, housing subscription accounts, etc.) by free-text query, optional region and category. Fuses a curated built-in corpus of representative 2026 policies with the ์จํต์ฒญ๋ (Youth Center) open API when a key is configured. Call this when the user asks what youth policies or support money they could get, or searches by topic (e.g. '์์ธ ์ง์', '์ทจ์ ์๋น', '๋ชฉ๋ ๋ง๋ จ'). Each result includes a summary and STRUCTURED eligibility criteria; then call check_eligibility with a policy_id to judge whether the user actually qualifies.
Inputs: query (required), k, region, category. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: searching policies, checking eligibility, retrieving details, managing user profiles, and finding centers. No overlapping functions; agents can easily differentiate.
All tools follow a consistent verb_noun pattern in snake_case (e.g., check_eligibility, search_youth_policies, remember_user_profile). No mixing of conventions.
With 6 tools, the server captures the essential workflow for youth policy navigation: search, detailed view, eligibility check, user context management, and offline center lookup. Well-scoped without bloat.
Core operations are covered: search, detail, eligibility, profile persistence, and location guidance. A minor gap is the absence of a tool to list all policies or update user profiles, but the current set handles typical user journeys effectively.
Maintenance
Related MCP Connectors
MCP server for VC pitch-deck scoring, thesis-fit matching, and deal-flow management.
AI governance MCP server for EU AI Act compliance and jurisdiction verification
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that gives AI agents the ability to discover, match with, and build relationships with other autonomous agents. Supports agent registration, matchmaking, messaging, shared goals, relationship lifecycle management, and real-time event subscriptions.55 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server that automates the entire process of discovering, evaluating, and applying for government support programs in South Korea using natural language. It integrates multiple public APIs to provide eligibility checks, document preparation, application timelines, and benefit management tools.1241ISC
- AlicenseNot gradedqualityDmaintenanceMCP server that exposes French public APIs (Data Inclusion, Lรฉgifrance, La Bonne Alternance) as tools for LLMs, enabling social, legal, and employment assistance.4MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables LLMs to search and retrieve Japanese government subsidy and grant information via natural language, wrapping the Jใฐใฉใณใ public API.MIT