toshl-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CACHE_TTL | No | Time to live for cached data in seconds (default: 3600) | 3600 |
| LOG_LEVEL | No | Logging level (default: info) | info |
| CACHE_ENABLED | No | Whether caching is enabled (default: true) | true |
| MCP_SERVER_NAME | No | The name of the MCP server (default: toshl-mcp-server) | toshl-mcp-server |
| TOSHL_API_TOKEN | Yes | Your Toshl API token | |
| MCP_SERVER_VERSION | No | The version of the MCP server (default: 0.1.0) | 0.1.0 |
| TOSHL_API_BASE_URL | No | The base URL for the Toshl API (default: https://api.toshl.com) | https://api.toshl.com |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| account_listA | List all accounts in Toshl Finance |
| account_getB | Get details of a specific account in Toshl Finance |
| category_listB | List all categories in Toshl Finance |
| category_getA | Get details of a specific category in Toshl Finance |
| category_createA | Create a new category in Toshl Finance |
| tag_listA | List all tags in Toshl Finance |
| tag_getA | Get details of a specific tag in Toshl Finance |
| tag_createB | Create a new tag in Toshl Finance |
| budget_listB | List all budgets in Toshl Finance |
| budget_getA | Get details of a specific budget in Toshl Finance |
| budget_historyB | Get history of a specific budget in Toshl Finance |
| user_profileB | Get user profile information from Toshl Finance |
| user_summaryC | Get account summary from Toshl Finance |
| user_payment_typesB | Get payment types from Toshl Finance |
| user_paymentsB | Get payments from Toshl Finance |
| entry_convert_to_transferA | Convert a regular entry to a transfer between accounts in Toshl Finance |
| entry_listC | List entries in Toshl Finance |
| entry_manageD | Manage entries in bulk in Toshl Finance. |
| entry_getA | Get details of a specific entry in Toshl Finance |
| entry_sumsC | Get daily sums of entries in Toshl Finance |
| entry_timelineC | Get timeline of entries in Toshl Finance |
| entry_createA | Create a new entry in Toshl Finance. To create a transfer between accounts, include a transaction object with the destination account ID and currency. |
| entry_updateC | Update an existing entry in Toshl Finance |
| entry_deleteB | Delete an entry in Toshl Finance |
| analyze_spending_by_categoryB | Analyze spending patterns by category |
| analyze_budget_performanceC | Analyze budget adherence |
| analyze_account_balanceC | Analyze account balances |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| List of Toshl accounts | List of all accounts in Toshl Finance |
| List of Toshl categories | List of all categories in Toshl Finance |
| List of Toshl tags | List of all tags in Toshl Finance |
| List of Toshl budgets | List of all budgets in Toshl Finance |
| Toshl user profile | User profile information from Toshl Finance |
| Toshl account summary | Summary of Toshl Finance accounts |
| List of Toshl entries | List of entries in Toshl Finance |
| Daily sums of Toshl entries | Daily sums of entries in Toshl Finance |
| Timeline of Toshl entries | Timeline of entries in Toshl Finance |
TDQS
Scored across 27 tools
Several tools overlap in scope: entry_list, entry_sums, and entry_timeline all query entries in different ways, and entry_manage may subsume create/update/delete operations. user_summary and account_list could be confused. However, most resource-specific tools are distinct.
Most tools use a resource_verb pattern (account_list, entry_get), but analyze_* breaks the pattern with verb_noun, and tools like user_profile, budget_history are noun-only. This mixing is inconsistent but still readable.
27 tools is above the 25 threshold, making the surface feel heavy. Although the finance domain has many resources, the count is excessive and some tools (e.g., entry_manage) could be merged with CRUD operations.
Entries have full CRUD coverage, but accounts, categories, tags, and budgets lack update/delete operations, and accounts have no create at all. This creates significant gaps for full lifecycle management, though read and analysis are well covered.