PastelSpend MCP Server

MCP server that exposes tools for the PastelSpend API.

• Base URL default: https://app-axry3s6qtkox.appmedo.com/api
• Auth: Authorization: Bearer <API_KEY> via PASTELSPEND_API_KEY

Install

npm install

Run locally

PASTELSPEND_API_KEY=your_key npm start

On Windows PowerShell:

$env:PASTELSPEND_API_KEY="your_key"
npm start

Environment variables

• PASTELSPEND_API_KEY (required)
• PASTELSPEND_API_BASE_URL (optional, defaults to production URL)
• You can copy .env.example values into your MCP client env config.

MCP tools

• get_expenses
• create_expense
• get_income
• create_income
• get_subscriptions
• scan_receipt_ocr (multipart upload; imagePath or imageBase64; supports /ocr/parse and /ocr/scan)
• generate_ai_analysis (tries POST /ai/analysis, falls back to GET /insights/analyze)
• get_ai_analysis (GET /ai/analysis)
• api_request (generic fallback for full spec surface)

Example MCP config

Use this command in your MCP client:

{
  "mcpServers": {
    "pastelspend": {
      "command": "node",
      "args": ["E:/psm/src/server.js"],
      "env": {
        "PASTELSPEND_API_KEY": "YOUR_API_KEY",
        "PASTELSPEND_API_BASE_URL": "https://app-axry3s6qtkox.appmedo.com/api"
      }
    }
  }
}

Publish to npm (optional)

npm publish

Then MCP clients can run it via:

{
  "command": "npx",
  "args": ["-y", "pastelspend-mcp-server"],
  "env": {
    "PASTELSPEND_API_KEY": "YOUR_API_KEY"
  }
}