Skip to content
MCP server

Recommand MCP by usefulapi

Read documents and the inbox, verify Peppol recipients and send invoices in Recommand.

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Recommand MCP by usefulapi

Recommand MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http recommand https://recommand.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://recommand.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "recommand": {
      "url": "https://recommand.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "recommand": {
      "type": "http",
      "url": "https://recommand.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "recommand": {
      "serverUrl": "https://recommand.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "recommand": {
      "type": "http",
      "url": "https://recommand.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (9)

Read directly from the server.

recommand_list_companies
List every company registered under the team, with its verification and Peppol registration status. Start here to get company ids. Not paginated. Recommand API: GET /api/v1/companies.
recommand_get_company
Get one company with its verification and Peppol registration status. Recommand API: GET /api/v1/companies/{companyId}.
recommand_list_labels
List every label in the team. Use a label id with recommand_list_documents (labelId). Recommand API: GET /api/v1/labels.
recommand_list_documents
List sent and received documents, one page at a time. Filter by company, direction, read status, dates, label or failed delivery (deliveryFailed true finds sends that need attention). Recommand API: GET /api/v1/documents.
recommand_get_document
Get one sent or received document with its parsed content and delivery status. Recommand API: GET /api/v1/documents/{documentId}.
recommand_get_inbox
List incoming documents that are not marked as read yet. Process a document, then call recommand_mark_document_read so it leaves the inbox. Not paginated. Recommand API: GET /api/v1/inbox.
recommand_verify_recipient
Look up a Peppol address in the directory before sending. Reports whether it is registered, the company name and the document types it accepts. isValid false means the lookup failed. Recommand API: POST /api/v1/verify.
recommand_send_invoice
SENDS A REAL INVOICE over the Peppol network, by email, or both. This cannot be undone, and each send counts toward the subscription usage. Check the buyer with recommand_verify_recipient first. Do NOT retry after a timeout: list the outgoing documents first, because the invoice may already be sent. If Peppol delivery fails and no email fallback applies, the call returns HTTP 422 and stores nothin
recommand_mark_document_read
Mark a document as read, which removes it from the inbox. Pass read false to mark it unread again. Calling it again with the same value does no harm. Recommand API: POST /api/v1/documents/{documentId}/mark-as-read.

Recommand MCP by usefulapi FAQ

How do I add Recommand MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http recommand https://recommand.usefulapi.io/mcp