Centerfield Visitor MCP

An MCP (Model Context Protocol) server that automates visitor reservations for the Centerfield building (www.centerfield.co.kr). Use it from any MCP-compatible AI agent (Kiro CLI, Claude Code, Strands Agents, …) to register visitors with natural language — single entries, pasted text, or Excel/CSV files.

센터필드 빌딩 방문예약을 자동화하는 MCP 서버입니다. Kiro CLI, Claude Code, Strands Agents 등 MCP 호환 AI 에이전트에서 자연어로 방문자를 등록할 수 있습니다.

Installation

No manual install needed — run directly with uvx:

uvx centerfield-visitor-mcp

MCP client configuration

Add the server to your MCP client config (example: Kiro CLI mcp.json). Set your own registered values via environment variables — nothing is hardcoded.

{
  "mcpServers": {
    "centerfield-visitor": {
      "command": "uvx",
      "args": ["centerfield-visitor-mcp"],
      "env": {
        "CF_COMPANY_NAME": "Your Company Name",
        "CF_PERSON_IN_CHARGE_MOBILE": "010XXXXXXXX",
        "CF_BUILDING": "east",
        "CF_BUILDING_KEY": "East"
      }
    }
  }
}

Configuration (environment variables)

Variable	Description	Default	Required
CF_COMPANY_NAME	Tenant company name as registered in Centerfield	(empty)	✅
CF_PERSON_IN_CHARGE_MOBILE	Mobile number of the approval contact registered in Centerfield	(empty)	✅
CF_BUILDING	Building code	east
CF_BUILDING_KEY	Building display key	East
CF_CENTERFIELD_BASE_URL	Centerfield base URL	https://www.centerfield.co.kr
CF_REQUEST_TIMEOUT	HTTP timeout (seconds)	30
CF_BULK_MAX_VISITORS	Max visitors per bulk request	200
CF_REQUEST_DELAY	Delay between bulk requests (seconds)	0.5

CF_PERSON_IN_CHARGE_MOBILE must be the mobile number registered as the tenant's approval contact in Centerfield. Reservations submitted with an unregistered number will fail. Provide it through your environment — never commit a real phone number.

Tools

Tool	Description
register_visitor	Register a single visitor
register_visitors_from_file	Bulk register from an Excel (.xlsx) or CSV file
register_visitors_from_text	Bulk register from pasted tab/CSV text
preview_visitors_from_file	Preview parsed visitors from a file (no registration)

File format

Bulk tools accept Excel/CSV with these columns (Korean or English headers are auto-mapped):

visitor_name, visitor_company_name, visitor_mobile, visitor_email, visit_date, visit_time
홍길동, ABC Inc., 01012345678, hong@abc.com, 2026-01-15, 10:00

How it works

The server holds a single authenticated session against the Centerfield site, manages CSRF tokens automatically, verifies the tenant company and approval contact, then submits the reservation form. Bulk requests are processed sequentially with a configurable delay to avoid rate limiting.

License

MIT