fitatu-mcp-unofficial: Instructions file for Codex

Agent Instructions

This repository implements an unofficial Model Context Protocol (MCP) server for Fitatu in TypeScript. These instructions define how an AI agent should work in this repository. They apply to the entire project unless a more specific AGENTS.md exists in a subdirectory.

1. Sources and their roles

Use each source for its stated purpose:

• The user's current request defines the scope and desired outcome.
• This file defines repository-wide working and implementation rules.
• ARCHITECTURE.md defines directory ownership, layer boundaries, dependency direction, model construction, and architectural review rules.
• package.json defines the available development, build, and verification commands.
• The official Model Context Protocol TypeScript SDK is the primary technical reference for MCP servers, tools, resources, schemas, and transports.
• PYTHON_REFERENCE_ENDPOINTS.md and the Python project at /Users/daniel/Projects/fitatu_mcp are read-only research sources.

If existing code conflicts with an architectural rule, do not copy or expand the inconsistency without first determining the intended design.

2. Non-negotiable rules

• Work on the current branch unless the user explicitly requests another branch.
• Read ARCHITECTURE.md before changing public models, service contracts, layer mappings, or MCP contracts.
• Keep MCP tools, application services, Fitatu HTTP clients, domain mapping, and error presentation in their owning layers.
• Validate external input and upstream data at the appropriate boundary.
• Keep secrets and personal data out of source code, logs, errors, fixtures, and committed output.
• Do not add new tests unless the user explicitly requests them. Modify existing tests when needed to keep them consistent with a change.
• Confirm that a script exists in package.json before running it.
• Do not copy the Python reference implementation mechanically.