ca-marketplace-scraper/packages/mcp-server/.ruler/AGENTS.md

packages/mcp-server

Scope

• This package is the MCP/JSON-RPC adapter over the API server.
• src/protocol/tools.ts defines tool schemas.
• src/protocol/handler.ts maps tool calls to API requests and JSON-RPC responses.
• src/protocol/metadata.ts exposes discovery metadata and protocol versioning.

Keep In Sync

• Tool definitions, handler argument mapping, and server metadata must stay consistent.
• When adding or renaming a tool, update tools.ts and handler.ts together.
• If protocol version or server-card details change, update both metadata.ts and initialize responses in handler.ts.

Protocol Rules

• Use MCP/JSON-RPC error codes and response envelopes, not ad-hoc API-style payloads.
• Keep this layer transport-focused. Marketplace behavior belongs in packages/core; HTTP semantics belong in packages/api-server.
• Preserve the current tool result shape unless the protocol contract is being changed deliberately: text content with JSON-stringified API results.

Verify

• bun test packages/mcp-server/test
• bun run --cwd packages/mcp-server build
• bun run ci