Every tool the Aktionariat AI MCP server exposes, what it does, what it requires, and example prompts that exercise it. This page is the canonical reference for both humans and agents — a Markdown version lives at /capabilities.md.
| Tool | Auth | Description | Example prompt |
|---|---|---|---|
| list_tokens | public | List all tokens (companies) issued via Aktionariat, with their symbol, name, and basic metadata. | “Show me all tokenized Swiss craft brewers on Aktionariat.” |
| get_token | public | Fetch detailed information about a single token: company description, supply, contract address, and links. | “Tell me about the Brauerei Locher token.” |
| order_book | public | Read the current bid/ask order book and recent trade history for a token. Useful for live market data. | “What’s the spread on BAB right now?” |
| person | public | Look up information about a public person or entity associated with a company (founder, board member, top holder). | “Who founded the company behind the BAB token?” |
| sign_in | public | Start an authenticated session by sending a PIN to a registered email or phone number. The PIN is then provided back to unlock the authenticated tools. | “Sign me in as alice@example.com.” |
| company_news | public | Recent news, filings, and announcements for one or more tokenized companies. Scope can be a single symbol, a list of symbols, or the signed-in user’s portfolio. | “Are there any news from companies in my portfolio?” |
| portfolio | authenticated | Read the signed-in user’s current holdings, positions, and aggregate value across all tokens. | “How is my portfolio doing this month?” |
| request_tax_report | authenticated | Generate and email the signed-in user a tax report for a given year, with cost basis, dividends, and realised gains. | “Send me my 2025 tax report.” |
| list_managed_companies | authenticated | List the companies the signed-in user is authorized to manage as an issuer. Other issuer tools (shareholder_registry, export_shareholder_registry) take a symbol returned by this tool. | “Show me the companies I can manage.” |
| shareholder_registry | authenticated | For issuers: read the top N holders of a managed company’s shareholder registry, sorted by ownership descending. Each row returns name, total shares owned, and ownership as a percentage. Default limit is 100; pass `limit` to fetch more. For privacy, email addresses and other personal contact details are intentionally excluded from the response — use export_shareholder_registry for the full file. | “Show me the top 100 shareholders of my company.” |
| export_shareholder_registry | authenticated | For issuers: generate a downloadable export of a managed company’s shareholder registry at a snapshot date. Supported formats: xlsx, pdf, google_sheets. Returns a download link; the actual addresses are written to the file, not the chat. | “Export my shareholder registry as XLSX as of today.” |
MCP server URL:
https://mcp.aai.aktionariat.com/mcp