`get_participant_endpoint`

Pack: peppol · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_participant_endpoint for the schema, then POST the same URL with its arguments for the data.

Get the AS4 delivery details a sender needs for one specific document type: transport profile, receiving endpoint URL, process identifier, and the service activation/expiration window. Call lookup_participant first to get the exact documentTypeId to pass here. An expired ServiceExpirationDate means the participant is listed but that document type is no longer deliverable.

Parameters

Name	Type	Required	Description
`participantId`	string	yes	Peppol participant identifier, e.g. “0192:989995278”.
`documentTypeId`	string	yes	Full document type identifier value exactly as lookup_participant returned it in documentTypes[].value, e.g. “urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1”.
`documentTypeScheme`	string	no	Document type scheme, default “busdox-docid-qns”.
`scheme`	string	no	Participant identifier scheme, default “iso6523-actorid-upis”.
`environment`	string	no	”production” (default) or “test”.

Example call

Arguments

{
  "participantId": "0208:1021916675",
  "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1"
}

curl

curl -X POST https://gateway.pipeworx.io/peppol/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_participant_endpoint","arguments":{"participantId":"0208:1021916675","documentTypeId":"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_participant_endpoint', {
  "participantId": "0208:1021916675",
  "documentTypeId": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1"
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the peppol pack

{
  "mcpServers": {
    "peppol": {
      "url": "https://gateway.pipeworx.io/peppol/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_participant_endpoint