@warmio/mcp 11.0.5 → 11.0.9

package/assets/logo.svg

@@ -1,14 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="600" height="469" viewBox="0 0 600 469" version="1.1">
-  <style>
-    :root {
-      color-scheme: light dark;
-      color: CanvasText;
-    }
-  </style>
-  <!-- Left segment -->
-  <path d="M 33.500 40.660 C 20.206 42.744, 0 48.560, -0 50.302 C -0 51.759, 123.955 348.889, 127.738 356.500 C 142.182 385.561, 169.450 410.275, 198.946 421.040 C 218.922 428.330, 243.683 430.825, 264.526 427.648 C 277.151 425.724, 294.628 420.011, 294.194 417.952 C 293.790 416.040, 172.732 124.599, 168.522 115.405 C 161.779 100.679, 149.168 84.171, 135.093 71.646 C 119.358 57.644, 98.880 47.362, 77 42.478 C 69.645 40.836, 40.220 39.606, 33.500 40.660" fill="currentColor" stroke="currentColor" stroke-width="8"/>
-  <!-- Center segment -->
-  <path d="M 229.651 41.597 C 217.916 43.718, 202.443 49.144, 202.744 51.035 C 203.418 55.268, 329.689 356.584, 333.687 363.500 C 340.525 375.327, 345.293 381.483, 355.408 391.538 C 374.603 410.619, 398.878 423.014, 425.907 427.533 C 439.649 429.831, 463.594 429.132, 476 426.072 C 489.892 422.645, 497.188 419.815, 496.703 418.043 C 495.416 413.331, 371.058 116.094, 367.406 109 C 349.467 74.149, 313.008 47.875, 273.752 41.509 C 262.281 39.648, 240.195 39.693, 229.651 41.597" fill="currentColor" stroke="currentColor" stroke-width="8"/>
-  <!-- Right segment -->
-  <path d="M 463 40.593 C 451.670 42.545, 447.288 43.569, 439 46.203 C 433.775 47.864, 429.338 49.372, 429.140 49.555 C 428.942 49.737, 434.670 64.021, 441.868 81.297 C 455.574 114.190, 462.215 131.660, 468.447 151.208 C 475.360 172.892, 486.124 186.213, 503.834 194.997 C 530.956 208.450, 564.982 201.679, 583.654 179.112 C 604.399 154.041, 605.407 121.944, 586.291 95.155 C 567.827 69.280, 539.107 50.114, 508 42.907 C 500.680 41.212, 494.713 40.644, 482 40.434 C 472.925 40.284, 464.375 40.356, 463 40.593" fill="currentColor" stroke="currentColor" stroke-width="8"/>
-</svg>

package/mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "warm": {
-      "command": "npx",
-      "args": ["-y", "@warmio/mcp@latest", "mcp"],
-      "env": {
-        "WARM_API_KEY": "${WARM_API_KEY}"
-      }
-    }
-  }
-}

package/skills/warm/SKILL.md

@@ -1,152 +0,0 @@
----
-name: warm
-description: Use Warm MCP tools to read financial context, retrieve transactions, search operations, and invoke approved automations.
----
-
-# Warm MCP Skill
-
-Use Warm MCP tools to read financial context, retrieve transactions, search operations, and invoke approved automations.
-
-## Available Tools
-
-### Read Tools
-
-**`get_financial_context`** — Read-only compact FinancialContext JSON. Includes:
-
-- `status.position` — current balances and net worth
-- `status.accounts` — connected accounts
-- Transaction index (total/months)
-- Recurring transactions
-- Budgets, goals, snapshots
-- Liabilities, holdings, health metrics
-
-Transaction items are not inline; use `get_transactions` to retrieve items.
-
-**`get_transactions`** — Read-only transactions from the FinancialContext artifact.
-
-- Pass `period: "latest"` for the fixed 10-day latest window
-- Pass `period: "YYYY-MM"` for a specific month (e.g. `"2024-01"`)
-- Months outside the covered range return an error
-- The latest window is not caller-configurable
-
-### Automation Tools
-
-**`search_operations`** — Search the supported Warm operation catalog.
-
-- Use this first to find the smallest matching operation
-- Optional `query` parameter: words describing the action or data you need (max 200 chars)
-- Returns matching operations with IDs and descriptions
-
-**`describe_operation`** — Describe one operation, including its input schema and risk.
-
-- Required: `operation_id` (string)
-- Optional: `input` (exact intended input)
-- For write operations, pass the exact intended input to receive an approval with:
-  - `approval_id` (UUID)
-  - Status, URL, and expiry timestamp
-- Use the approval_id to invoke the operation
-
-**`invoke_operation`** — Invoke one previously discovered Warm operation.
-
-- Required: `operation_id` (string)
-- Optional: `input` (operation parameters)
-- Optional: `approval_id` (UUID, required for write operations)
-- Every write operation requires the `approval_id` returned for the exact same input by `describe_operation`
-- Returns operation result with status, body, headers, and operation_id
-
-## Workflow
-
-### Reading Financial Data
-
-1. Call `get_financial_context` to get the overview
-2. Call `get_transactions` with `period: "latest"` or `period: "YYYY-MM"` to retrieve transactions
-
-### Invoking Automations
-
-1. Call `search_operations` with optional query to find relevant operations
-2. Call `describe_operation` with the `operation_id` and exact `input` to get approval (for writes)
-3. **Wait for owner approval**: For write operations, surface the `approval.url` to the user and wait for them to visit it and approve in Warm Settings
-4. Call `invoke_operation` with the `operation_id`, `input`, and `approval_id` (only after approval status changes from `pending`)
-
-## Important Rules
-
-- **Never move money without explicit approval**: Write operations require an `approval_id` from `describe_operation` AND owner approval at the returned `approval.url`
-- **Wait for owner approval**: After calling `describe_operation` for a write, surface the `approval.url` and wait for owner confirmation before calling `invoke_operation`
-- **Use exact input for approval**: The `input` passed to `describe_operation` must match exactly the `input` passed to `invoke_operation`
-- **Check operation risk**: Review the risk level in `describe_operation` response before proceeding
-- **Respect expiry**: Approval IDs have an expiry timestamp; check before invoking
-- **Handle errors**: Operations return status codes; check for success (2xx) vs error (4xx/5xx). A 409 status typically means the approval is still `pending` and not yet approved by the owner
-
-## Examples
-
-### Get Financial Overview
-
-```typescript
-// Step 1: Get context
-const context = await get_financial_context({});
-console.log(`Net worth: $${context.status.position.net_worth}`);
-
-// Step 2: Get recent transactions
-const transactions = await get_transactions({ period: 'latest' });
-console.log(`Recent transactions: ${transactions.items.length}`);
-```
-
-### Search and Invoke Operation
-
-```typescript
-// Step 1: Search for operations
-const results = await search_operations({
-  query: 'create budget',
-});
-
-// Step 2: Describe the operation with exact input
-const description = await describe_operation({
-  operation_id: 'budgets.create',
-  input: {
-    body: {
-      name: 'Groceries',
-      budget_type: 'category',
-      amount: 500,
-      period: 'monthly',
-      rollover_enabled: false,
-    },
-  },
-});
-
-// Step 3: Owner must approve at the returned URL
-console.log(`Approval required: ${description.approval.url}`);
-console.log(`Status: ${description.approval.status}`); // "pending"
-// Owner visits URL, reviews, and approves
-
-// Step 4: After owner approval, invoke with approval_id
-const result = await invoke_operation({
-  operation_id: 'budgets.create',
-  input: {
-    body: {
-      name: 'Groceries',
-      budget_type: 'category',
-      amount: 500,
-      period: 'monthly',
-      rollover_enabled: false,
-    },
-  },
-  approval_id: description.approval.id,
-});
-```
-
-## Error Handling
-
-- API errors return structured JSON with `error` and `status` fields
-- Transaction queries for invalid months return descriptive errors
-- Write operations without valid approval_id fail with 403/401 errors
-- Always check operation status codes before treating results as successful
-
-## Authentication
-
-The Warm MCP server uses the `WARM_API_KEY` environment variable for authentication. This is automatically configured by the Cursor plugin when you provide your API key.
-
-Get your API key from: https://warm.io/settings/api-keys
-
-## Documentation
-
-Full API documentation: https://warm.io/developers