# Capabilities

The full tool surface exposed by the Aktionariat AI MCP server.

## Tools

| 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.” |

## Example prompts

### For the public

- List all tokenized Swiss companies on Aktionariat.
- What’s the current price and 24-hour volume for the Brauerei Locher token?
- Show me the order book for BOSS and explain whether it looks liquid.
- Which companies on Aktionariat are in the food and beverage sector?

### For shareholders

- Sign me in and show me my current portfolio.
- How much did my BAB position move this week?
- Generate my 2025 tax report and email it to me.
- When was my last dividend payment, and how much was it?

### For companies

- Summarise trading activity on our token over the last 30 days.
- How many new wallet addresses received our token this month?
- What’s the average bid–ask spread on our order book this quarter?
- Pull up our top 10 holders and flag any changes since last month.

## Connect via MCP

**MCP server URL:** `https://mcp.aai.aktionariat.com/mcp`

### Claude Desktop

1. Open Claude Desktop → Settings → Developer.
2. Add a new MCP server with the URL above.
3. Restart Claude. The Aktionariat tools will appear in any new conversation.

### Claude.ai (web)

1. Open claude.ai → Settings → Connectors.
2. Click “Add custom connector” and paste the MCP server URL.
3. Authorize the connector — public tools work immediately; sign in with `sign_in` to unlock personal tools.

### Other MCP clients

- Cursor, Continue, Cline, and other MCP-aware clients accept the same URL via their respective MCP configuration files.
- See https://modelcontextprotocol.io for the full client list.

---

Human version: https://aai.aktionariat.com/capabilities