Run my Accounts MCP by usefulapi

Read customers, invoices, vendor bills, trial balance and ledger transactions in Run my Accounts.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
76%
Naming quality
93%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (6)

  • LOWTool 'runmyaccounts_list_invoice_payments' name length outside 3-30 rangein runmyaccounts_list_invoice_payments
  • LOWTool 'runmyaccounts_list_payments_since' name length outside 3-30 rangein runmyaccounts_list_payments_since
  • LOWTool 'runmyaccounts_list_vendor_invoices' name length outside 3-30 rangein runmyaccounts_list_vendor_invoices
  • LOWTool 'runmyaccounts_get_vendor_invoice' name length outside 3-30 rangein runmyaccounts_get_vendor_invoice
  • LOWTool 'runmyaccounts_list_vendor_invoice_payments' name length outside 3-30 rangein runmyaccounts_list_vendor_invoice_payments
  • LOWTool 'runmyaccounts_list_account_transactions' name length outside 3-30 rangein runmyaccounts_list_account_transactions

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,034Tokens (tool definitions)
~816 BTypical response size
Moderate attention impact (1.59% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "run-my-accounts": {
      "url": "https://run-my-accounts.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://run-my-accounts.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢runmyaccounts_list_customers

List all customers (debtors) with number, name, address, contact and bank data. API: GET /customers.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_get_customer(customer_number)

Get one customer by customer number. API: GET /customers/{customernumber}.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_number": {
      "type": "string",
      "minLength": 1,
      "description": "Customer number, for example K-001."
    }
  },
  "required": [
    "customer_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_invoices(status, from, to, customer_number)

List customer invoices. Filter by status (OPEN, PAID, OVERDUE), date range and customer number. API: GET /invoices.

Input Schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Invoice status. OPEN includes due and overdue.",
      "type": "string",
      "enum": [
        "OPEN",
        "PAID",
        "OVERDUE"
      ]
    },
    "from": {
      "description": "Invoices on or after this date (yyyy-mm-dd). Default: account close date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Invoices on or before this date (yyyy-mm-dd). Default: today.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "customer_number": {
      "description": "Only invoices of this customer number.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_get_invoice(invoice_number)

Get one customer invoice with its customer and line items. API: GET /invoices/{invoice_number}.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "string",
      "minLength": 1,
      "description": "Invoice number, for example R-002."
    }
  },
  "required": [
    "invoice_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_invoice_payments(invoice_number)

List the payments booked against one customer invoice. API: GET /invoices/{invoice_number}/payments.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "string",
      "minLength": 1,
      "description": "Invoice number."
    }
  },
  "required": [
    "invoice_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_payments_since(processed)

List incoming invoice payments that were not marked as processed after a time stamp. This tool only reads: it never marks a payment as processed. API: GET /invoices/payment_list?processed=.

Input Schema

{
  "type": "object",
  "properties": {
    "processed": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
      "description": "Time stamp, format yyyy-MM-ddTHH:mm."
    }
  },
  "required": [
    "processed"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_parts

List parts (articles) with number, description, unit, price and account numbers. API: GET /parts.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_vendors(sort, query)

List vendors (creditors). Sort by id, name, vendornumber or score (add asc or desc) and search by name. API: GET /vendors.

Input Schema

{
  "type": "object",
  "properties": {
    "sort": {
      "description": "For example 'vendornumber desc'.",
      "type": "string",
      "pattern": "^(id|name|vendornumber|score)( (asc|desc))?$"
    },
    "query": {
      "description": "Search text in the vendor name.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_vendor_invoices

List vendor invoices (payables) with status, amounts, paid amount and vendor. API: GET /payables.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_get_vendor_invoice(invoice_number)

Get one vendor invoice by invoice number. API: GET /payables/{invoice_number}.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "string",
      "minLength": 1,
      "description": "Vendor invoice number, for example K-001."
    }
  },
  "required": [
    "invoice_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_vendor_invoice_payments(invoice_number)

List the payments booked against one vendor invoice. API: GET /payables/{invoice_number}/payments.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_number": {
      "type": "string",
      "minLength": 1,
      "description": "Vendor invoice number."
    }
  },
  "required": [
    "invoice_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_charts(type)

List the chart of accounts. Optionally filter by account type. API: GET /charts.

Input Schema

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Account type filter.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_trial_balance(accno, from, to, department, project, ...)

Get account balances (trial balance, version 2). Use x as a wildcard in accno (15xx = 1500 to 1599). Income statement accounts need from and to. API: GET /gl/v2/saldo.

Input Schema

{
  "type": "object",
  "properties": {
    "accno": {
      "description": "Account number filter, x is a wildcard, for example 15xx.",
      "type": "string"
    },
    "from": {
      "description": "Include transactions from this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Include transactions until this date (default today).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "department": {
      "description": "Only transactions of this department.",
      "type": "string"
    },
    "project": {
      "description": "Only values with this project name.",
      "type": "string"
    },
    "include_openings": {
      "description": "Include opening balances (default true).",
      "type": "boolean"
    },
    "exclude_yearend_bookings": {
      "description": "Ignore year-end offsets.",
      "type": "boolean"
    },
    "bookkeeping_main_curr": {
      "description": "Show balances in the main currency (default true).",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_account_transactions(accno, from_date, to_date, include_openings, include_closings)

List ledger transactions of one account or a wildcard pattern (x matches any digit, use x for all accounts). API: GET /charts/{accno}/transactions.

Input Schema

{
  "type": "object",
  "properties": {
    "accno": {
      "type": "string",
      "minLength": 1,
      "description": "Account number or pattern, for example 1000 or 10xx."
    },
    "from_date": {
      "description": "Include transactions from this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to_date": {
      "description": "Include transactions until this date (default today).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "include_openings": {
      "description": "Include opening balances (default true).",
      "type": "boolean"
    },
    "include_closings": {
      "description": "Include closing balances (default true).",
      "type": "boolean"
    }
  },
  "required": [
    "accno"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_departments

List departments (cost and profit centers). API: GET /departments.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢runmyaccounts_list_projects

List projects. API: GET /projects.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools