# Elorus — how to use (mcp.ai)

Connect your Elorus account and use 13 tools for proposals and invoices straight from your AI agent. Connect with your own API key. Elorus is an online invoicing and time-tracking software designed for freelancers and small businesses to manage their finances and projects efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_elorus?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `elorus_create_invoice`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/elorus`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/elorus/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/elorus/create/invoice` — Creates a new invoice or receipt in Elorus. Invoices are automatically saved as drafts by default and use the 'initial' calculation mode (amounts specified before taxes). Required: issue_date, currenc
  - body: { kind: string, tags?: string[], items: object[], notes?: string, discount?: number, client_id: string, series_id: string, issue_date: string, currency_id: string, payable_date?: string, document_number?: string, contact_address_id?: string }
- `POST https://api.mcp.ai/api/elorus/create/product` — Create a new product or service in Elorus. Use this to add items to your product catalog with pricing, tax settings, and inventory management options.
  - body: { code?: string, sales?: boolean, stock?: string, title: string, active?: boolean, manage?: boolean, custom_id?: string, purchases?: boolean, sale_taxes?: string[], sale_value?: string, taric_code?: string, description?: string, unit_measure?: string, purchase_taxes?: string[], purchase_value?: string }
- `POST https://api.mcp.ai/api/elorus/email/invoice` — Tool to email an existing invoice to specified contacts. Use after generating an invoice and obtaining contact IDs.
  - body: { cc?: string[], bcc?: string[], contacts: integer[], email_body: string, invoice_id: integer, email_subject: string }
- `POST https://api.mcp.ai/api/elorus/get/bills` — Retrieve a paginated list of bills (expenses/purchases) from Elorus. Supports filtering by supplier, date range, status, and text search. Use this to view and manage bills created in your organization
  - body: { page?: integer, period?: string, search?: string, status?: string, ordering?: string, supplier?: string, page_size?: integer, period_to?: string, period_from?: string }
- `POST https://api.mcp.ai/api/elorus/get/contacts` — Tool to retrieve a list of contacts. Use after authentication to fetch contacts in batches. Example: 'List page 2 of active company contacts sorted by name.'
  - body: { page?: integer, search?: string, order_by?: string, statuses?: string[], is_company?: boolean, sort_order?: string, contact_ids?: integer[], custom_fields?: object, show_archived?: boolean, items_per_page?: integer }
- `POST https://api.mcp.ai/api/elorus/get/credit/notes` — Tool to retrieve a list of credit notes. Use when you need to fetch credit notes filtered by page, contact, date range, or currency.
  - body: { page?: integer, contact?: integer, currency?: string, page_size?: integer, issued_on__gte?: string, issued_on__lte?: string }
- `POST https://api.mcp.ai/api/elorus/get/email/templates` — Tool to retrieve a list of email templates. Use when you need to fetch and page through existing templates in the organization.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/elorus/get/estimates` — Tool to retrieve a list of estimates. Use when you need to list estimates with pagination after creation.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/elorus/get/invoices` — Retrieves a paginated list of invoices from Elorus with flexible filtering options. Use this tool to: - List all invoices or filter by client, status, date ranges, currency, or tags - Paginate through
  - body: { page?: integer, tags?: string, number?: string, status?: string, contact?: string, currency?: string, ordering?: string, page_size?: integer, due_date__gte?: string, due_date__lte?: string, issue_date__gte?: string, issue_date__lte?: string }
- `POST https://api.mcp.ai/api/elorus/get/products` — Tool to retrieve a list of products/services with optional filtering, sorting, and pagination. Use when you need to fetch products for reports, UI lists, or inventory management.
  - body: { page?: integer, sort?: string, limit?: integer, fields?: string, filter?: string }
- `POST https://api.mcp.ai/api/elorus/get/taxes` — Tool to retrieve a list of taxes. Use after authentication to list taxes with optional filters.
  - body: { q?: string, page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/elorus/get/templates` — Retrieves document templates used for formatting invoices, estimates, credit notes, and other business documents in Elorus. Templates define the visual layout, language, company branding, and default 
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/elorus/update/contact` — Update an existing contact in Elorus by ID. Allows modifying contact details such as name, company, addresses, and communication preferences. Use this tool when you need to: - Update contact informati
  - body: { id: string, email?: object[], phones?: object[], company?: string, addresses?: object[], custom_id?: string, is_client?: boolean, last_name?: string, first_name?: string, profession?: string, vat_number?: string, is_supplier?: boolean, default_language?: string, default_currency_code?: string }

## Example prompts
- "What can I do in Elorus?"
- "Show me a summary of my Elorus account"

## More
- Page: https://mcp.ai/elorus
- Agent spec (llms.txt): https://mcp.ai/elorus/llms.txt
- Postman collection: https://mcp.ai/elorus/postman.json