Get Started with Aktionariat MCP

This page walks through connecting the Aktionariat AI MCP server to your client of choice. The server URL is the same everywhere:

https://mcp.ai.aktionariat.com/mcp

Public tools (token listings, order books) work right after connecting. To unlock personal tools (portfolio, tax reports) or issuer tools (shareholder registry, proposals), call the sign_in tool inside your client and authenticate with the PIN sent to your Aktionariat email.

1. Add the Connector

Claude

1. Open claude.ai and go to Settings → Connectors.

   In Claude Desktop, open Settings → Connectors — the same dialog appears.

2. Click Add custom connector.

3. Paste the MCP server URL:

   https://mcp.ai.aktionariat.com/mcp

4. Confirm the connector. Claude opens the Aktionariat OAuth dialog — for read-only public access you can dismiss it; for personal access enter your Aktionariat email to receive a PIN.

5. The Aktionariat tools now appear in any new conversation under the connectors menu.

ChatGPT

1. Open chatgpt.com and go to Settings → Connectors (currently rolling out to Plus, Pro, Team, Enterprise, and Edu workspaces).

2. Click Add connector → Custom MCP server.

3. Paste the MCP server URL:

   https://mcp.ai.aktionariat.com/mcp

4. Approve the connector. ChatGPT walks you through OAuth — enter your Aktionariat email to receive a PIN when you want to unlock personal tools.

5. In a new chat, enable the Aktionariat connector from the tools menu and start asking questions about tokenized companies.

Claude Code

1. Install Claude Code if you have not already.

2. Add the Aktionariat MCP server from the command line:

   claude mcp add --transport http aktionariat https://mcp.ai.aktionariat.com/mcp

3. Start (or restart) Claude Code. The Aktionariat tools are now available in any session.

4. Run /mcp inside Claude Code to confirm the connection and to trigger the OAuth flow when you want to sign in for personal tools.

2. Verify the Connection

Ask a public question that doesn’t require sign-in. The agent should call list_tokens and return the hand-onboarded companies on Aktionariat.

Claude

Open a new conversation, make sure the Aktionariat connector is enabled, and ask:

List the tokenized companies on Aktionariat.

ChatGPT

Open a new chat, enable the Aktionariat connector from the tools menu, and ask:

List the tokenized companies on Aktionariat.

Claude Code

In your terminal session, ask:

List the tokenized companies on Aktionariat.

If you see a table of tokens with tickers, issuer names, and contract addresses, the connector is working.

3. Sign In for Personal Tools

Personal tools (portfolio, request_tax_report, my_secondary_market_orders) and issuer tools (shareholder_registry, list_proposals, …) require a signed-in session.

Claude

1. Ask Claude to “sign me in to Aktionariat” — it will call the sign_in tool.

2. Claude reopens the Aktionariat OAuth dialog. Enter the email address you use on Aktionariat.

3. Check that email for a PIN. Type the PIN into the dialog to complete sign-in.

4. Retry the action that needed authentication — Claude now has a personal session and can call the personal tools on your behalf.

ChatGPT

1. Ask ChatGPT to “sign me in to Aktionariat” — it will call the sign_in tool.

2. ChatGPT reopens the Aktionariat OAuth dialog. Enter the email address you use on Aktionariat.

3. Check that email for a PIN. Type the PIN into the dialog to complete sign-in.

4. Retry the action that needed authentication — ChatGPT now has a personal session and can call the personal tools on your behalf.

Claude Code

1. Run /mcp in Claude Code and choose Authenticate for the Aktionariat server, or simply ask the assistant to “sign me in to Aktionariat”.

2. Claude Code opens a browser tab with the Aktionariat OAuth dialog. Enter your Aktionariat email.

3. Check that email for a PIN and complete sign-in in the browser tab.

4. Return to the terminal — the session is now signed in and personal tools are available.

Switching accounts

Calling sign_in again resets the current session. The next tool call triggers a fresh OAuth flow, which is the canonical way to switch accounts or sign out.

4. Try a Few Prompts

A handful of starting points, by audience:

As a member of the public

• “What tokenized companies are on Aktionariat?”
• “What is the current order book for DAKS?”
• “Who is the issuer behind the DAKS token?”

As a signed-in investor

• “Show me my portfolio.”
• “List my open secondary-market orders for Aktionariat AG.”
• “Send me my 2025 tax report as a PDF.”

As an issuer administrator

• “Which companies can I manage?”
• “Show me the top 50 shareholders for my company.”
• “Export my shareholder registry as XLSX as of today.”
• “List the pending multisig proposals for my company and start signing the most recent one.”

For the full tool reference and the example prompts each tool can answer, see the per-tool pages under Guides.