feat: rebuild axanta-erp MCP server with FastMCP

[vidaunited]

Summary

• Rebuilt the Axanta ERP MCP server (tools/mcp-servers/axanta_mcp_server.py) following the mcp-builder skill's best practices
• Upgraded from low-level mcp.server.Server to FastMCP framework with Pydantic input validation, tool annotations, and lifespan-managed connections
• Updated skills/axanta-erp/SKILL.md to reflect new namespaced tool names and updated install instructions

What changed

MCP Server (axanta_mcp_server.py)

Before	After
mcp.server.Server (low-level)	FastMCP with lifespan context manager
Auth at module import (crashes if env vars missing)	Lazy auth via app_lifespan with clear error messages
Raw dict input schemas	Pydantic BaseModel with Field() constraints and field_validator
No pagination metadata	Full pagination: total, count, offset, has_more, next_offset
Generic tool names (search_records)	Namespaced names (axanta_search_records) to prevent conflicts
No tool annotations	Full annotations: readOnlyHint, destructiveHint, idempotentHint, openWorldHint
Bare except Exception returning raw errors	Actionable error messages for AccessError, MissingError, ConnectionRefused, etc.

Skill file (SKILL.md)

• Updated install command: pip install "mcp[cli]" pydantic
• Updated tool name table to match new axanta_ prefixed names

Test plan

• Run python3 -c "import py_compile; py_compile.compile('tools/mcp-servers/axanta_mcp_server.py', doraise=True)" — syntax check passes
• Set AXANTA_URL, AXANTA_DB, AXANTA_USER, AXANTA_KEY env vars and run claude mcp add axanta-erp -- python3 tools/mcp-servers/axanta_mcp_server.py
• Verify /mcp shows axanta-erp server with all 12 tools
• Test read-only tools: axanta_get_inventory, axanta_get_customers, axanta_get_sales_summary
• Test write tools: axanta_create_record, axanta_update_record
• Verify pagination works with offset parameter

🤖 Generated with Claude Code

https://claude.ai/code/session_01DabQMAvcuSTywVbemuNSsu

---

Generated by Claude Code