Skip to main content
Version: 12 - TBD

ConnectorTypeJSONRPC

class connector_types.connector_type_jsonrpc.ConnectorTypeJSONRPC(*args, **kwargs)

Base class: ConnectorTypeREST

JSON-RPC 2.0 client connector.

Reuses the REST connector's engine-side HTTP transport -- URL building, authentication (none / bearer / basic / secret-headers / OAuth2 grant), TLS, proxy, timeouts and the cancellation-aware send -- and layers JSON-RPC 2.0 request/response semantics on top.

execute POSTs a {"jsonrpc": "2.0", "method", "params", "id"} envelope as application/json and parses the response envelope: the result member is returned in the result output; a JSON-RPC error member ends the connection with ENDED_ERROR while still returning the error object in the error output. A notification (no id) expects no response body.

JSON-RPC 2.0 is MCP's transport, so this connector can also drive an MCP server by composing the initialize / tools/list / tools/call method calls from a flow (transport headers such as Accept or a session id are set via the Headers input).

Parameters​

NameTypeDescription
**kwargs
*args

Input Schema​

  • schema_version = '2026-08-12'

    Type: string

  • authentication

    Type: anyOf

  • scheme

    The scheme to use. https connections are encrypted with TLS/SSL and expose the TLS options.

    Type: anyOf

  • host

    The remote hostname or IP address.

    Type: string

  • port

    Type: anyOf

  • base_path

    A part of the path. The full path will be <base path>/<path>.

    Type: string

  • path

    The path of the JSON-RPC endpoint. The full path will be <base path>/<path>.

    Type: string

    Default: /

  • query

    Will be urlencoded automatically

    Type: array

  • fragment

    The fragment of the URI.

    Type: string

  • method

    The JSON-RPC method name to call.

    Type: string

  • params

    The JSON-RPC params -- a JSON array (positional) or object (named). Leave empty to omit the member entirely.

  • notification

    Send as a JSON-RPC notification: omit the id member and do not expect a response body (the server must not reply with a result or error).

    Type: boolean

  • request_id

    The JSON-RPC request id. Leave empty to auto-generate a unique id. Ignored when Notification is set.

    Type: string

  • headers

    Additional headers to send with the request.

    Type: array

  • expected_status_code

    HTTP status codes which are treated as a successful transport. Any other HTTP status code ends the connection with ENDED_ERROR before the JSON-RPC envelope is parsed.

    Type: array

    Default: [200, 201, 202, 204]

  • total_timeout

    Total timeout for the request in seconds.

    Type: integer

    Default: 30

  • connect_timeout

    A timeout for connecting to a peer in seconds.

    Type: integer

    Default: 30

  • read_timeout

    A timeout for reading a portion of data from a peer in seconds.

    Type: integer

    Default: 30

  • proxy

    Use a proxy to connect to the server.

    Type: object

    Additional Properties: False

  • idempotent

    Whether re-running this connection from the start is safe (no duplicate side effects). Controls recovery after the connection between Cloudomation and the remote system is lost and later re-established (network glitch, workspace restart, ...): repeatable connections are left running to be reattached or re-run, others are cancelled. Leave unset to let the connector decide based on the operation.

Output Schema​

Constants​

supports_reconnect = False