57db3fe388
Cover GenerateKycUploadUrlsHandler (10 tests) and SubmitKycHandler (10 tests): presigned URL flow, legacy file upload, status validation, error handling. Co-Authored-By: Paperclip <noreply@paperclip.ing>
@goodgo/mcp-servers
MCP (Model Context Protocol) tool server library for the GoodGo Platform. Provides structured tools that AI assistants can use to query property data, run analytics, and perform valuations.
Tool Servers
| Server | Path | Description |
|---|---|---|
| Property Search | property-search/ |
Geo search, full-text search, filter by type/price/area |
| Market Analytics | market-analytics/ |
Price trends, heatmaps, district comparisons |
| Valuation | valuation/ |
AVM property valuation requests |
Tech Stack
- TypeScript 6+
- @modelcontextprotocol/sdk 1.12 (MCP protocol implementation)
- Zod 3.24 (schema validation)
- NestJS integration module (optional peer dependency)
Project Structure
libs/mcp-servers/
├── src/
│ ├── index.ts # Public API exports
│ ├── property-search/ # Property search tool server
│ ├── market-analytics/ # Market analytics tool server
│ ├── valuation/ # AVM valuation tool server
│ ├── nestjs/ # NestJS module integration
│ ├── shared/ # Shared types and utilities
│ └── __tests__/ # Test suite
├── package.json
└── tsconfig.json
Usage
import { PropertySearchServer, MarketAnalyticsServer } from '@goodgo/mcp-servers';
The MCP endpoints are exposed via the API's apps/api/src/modules/mcp/ module.
Building
pnpm --filter @goodgo/mcp-servers build
Testing
pnpm --filter @goodgo/mcp-servers test