Skip to content
Aktionariat

sign_in

Reset the current MCP session so the host re-runs the OAuth login. This is the canonical way to:

  • Upgrade an anonymous session to a signed-in one.
  • Switch from one Aktionariat account to another.
  • Sign out of the connector.

After calling sign_in, ask the agent to retry the original action — the MCP host (Claude, ChatGPT, Claude Code) prompts for sign-in via Aktionariat’s email + PIN flow.

Authentication

Section titled “Authentication”

Public. The tool itself is unauthenticated and is the entry point that produces authentication.

Inputs

Section titled “Inputs”

None.

Output

Section titled “Output”

A small status object — number of grants and tokens revoked, and the session’s userId for diagnostics. The user-visible message tells the agent to retry the previous action.

Example Prompts

Section titled “Example Prompts”
  • “Sign me in to Aktionariat.”
  • “Switch to a different Aktionariat account.”
  • “Sign me out of Aktionariat.”

Notes for Agents

Section titled “Notes for Agents”
  • sign_in does not itself sign the user in — it resets the session so the next tool call triggers the host’s OAuth flow.
  • After calling it, immediately ask the user (or the agent’s plan) what action to retry; do not assume the user remembers which task started the sign-in.
  • Personal tools (portfolio, request_tax_report, my_secondary_market_orders) and all issuer tools refuse to run without an active signed-in session and will instruct the agent to call sign_in first.