API Docs

Two ways to talk to Oxinion Finance: an MCP client (Claude, Cursor) using your API key, or the Telegram bot directly.

Point your client at https://mcp.oxinion.com/finance/mcp. Auth is per-tool, not required for the whole connection:

• stock-analysis works with no key at all.
• portfolio-analysis and run-autopilot need a Bearer token — generate one on the API Keys page and pass it along; without it (or with a revoked key) those two return an error telling you to get one.

Claude Code (CLI)

# API key auth
claude mcp add --transport http oxinion-finance \
  https://mcp.oxinion.com/finance/mcp \
  --header "Authorization: Bearer <YOUR-API-KEY>"

Claude Desktop / Cursor (via mcp-remote)

{
  "mcpServers": {
    "oxinion-finance": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.oxinion.com/finance/mcp",
        "--header",
        "Authorization: Bearer <YOUR-API-KEY>"
      ]
    }
  }
}

Clients with native remote-MCP + header support

{
  "mcpServers": {
    "oxinion-finance": {
      "url": "https://mcp.oxinion.com/finance/mcp",
      "headers": { "Authorization": 
        "Bearer <YOUR-API-KEY>"
      }
    }
  }
}

No API key needed — this is a separate, chat-only connection tied to your Telegram account.

1. Open the link above (or search @oxinionBot in Telegram) and tap Start.
2. Send a ticker symbol — TSLA or $COST both work.
3. The bot replies with price, RSI, trend, score, and signal for that ticker.

Covers the Oxinion Finance Global Top 100 only. It only understands exact ticker commands, not free-form questions.