# Alva MCP Integration Notes

Alva publishes MCP discovery metadata so AI agents can identify the MCP server, available investing workflow tools, and authentication boundaries.

## Public MCP discovery

- MCP server card: https://alva.ai/.well-known/mcp/server-card.json
- MCP server URL: https://mcp.alva.ai
- Developer guide: https://alva.ai/developers
- Authentication guide: https://alva.ai/auth.md

## Tool categories

- Research an investing thesis with public and authenticated Alva context.
- Backtest an investing strategy or market scenario before risking capital.
- Create or update a playbook only after the user explicitly confirms the action.

## Auth boundary

Alva is not financial advice. Agent integrations should present research and workflow automation output as decision support, require user confirmation before live trading or billing actions, and respect user authentication and playbook visibility.

Agents should treat `401` and `403` from MCP-style calls as protected user-scoped actions, not as missing product capabilities. No public page embeds test tokens or private secrets.
