Joined MCP Server

This MCP Server joins the following MCP servers together, to provide a single endpoint for them all.

Internet Content

A Model Context Protocol (MCP) server resource permitting MCP clients to access Internet Content using GET, POST, PUT, DELETE and QUERY methods, as well as encoding and decoding Internet Content. Requests use the server's certificate for mTLS, if such is available.

Event Log

A Model Context Protocol (MCP) server resource permitting MCP clients to log events to the Event Log. Alert and Emergency events also get propagated to operators immediately.

File Storage

A Model Context Protocol (MCP) server resource permitting MCP clients to store and manage persistent files in an account-specific file storage.

XMPP MCP Server

A Model Context Protocol (MCP) server resource permitting MCP clients to access the federated XMPP network and send and receive messages, perform information queries and publish their presence. Before messages and queries can be made, the MCP client should first request the presence subscription of the contact to whom messages are queries should be sent.

Identity MCP Server

A Model Context Protocol (MCP) server resource permitting MCP clients to apply for, and manage digital legal identities.

Payments MCP Server

A Model Context Protocol (MCP) server resource permitting MCP clients to make payments using TAG infrastructure. Before payments can be made, the MCP client must first have an XMPP account and a Legal Identity with sufficient personal information defined and approved for that account.

Table of Contents
  1. Joined MCP Server
    1. Internet Content
    2. Event Log
    3. File Storage
    4. XMPP MCP Server
    5. Identity MCP Server
    6. Payments MCP Server
    7. MCP Server Interface
    8. MCP Server Tools
      1. Accept Presence Subscription
      2. Add Photo Attachment (BASE64 upload)
      3. Add Photo Attachment (User Input)
      4. Add Photo Attachment (URL Download)
      5. Add to Roster
      6. Append Binary File
      7. Append Text File
      8. Apply For New Personal Identity
      9. Buy eDaler
      10. Compromise Identity
      11. Create Binary File
      12. Create Open Smart Contract
      13. Create Open Payment URI
      14. Create Payment URI to Bare JID
      15. Create Payment URI to Legal ID
      16. Create Pay-Me URI
      17. Create Text File
      18. Decline Presence Subscription
      19. Delete
      20. Delete File
      21. Edit
      22. Get
      23. Get Balance
      24. Get Options for Buying eDaler
      25. Get Identity Application Properties
      26. Get Message
      27. Get Peer Review Providers
      28. Get Pending Payments
      29. Get Options for Selling eDaler
      30. Get Service Providers for Buying eDaler
      31. Get Service Providers for Selling eDaler
      32. Log Alert Event
      33. Log Critical Error Event
      34. Log Debug Event
      35. Log Emergency Event
      36. Log Error Event
      37. Log Informational Event
      38. Log Notice Event
      39. Log Warning Event
      40. Obsolete Identity
      41. Make Payment to Bare JID
      42. Make Payment to Legal ID
      43. Petition Legal Identity
      44. Petition Peer Review
      45. Petition Digital Signature
      46. Petition Smart Contract
      47. Pop Message
      48. Post
      49. Process Payment URI
      50. Propose Smart Contract
      51. Put
      52. Query
      53. Ready For Approval Identity
      54. Remove Attachment
      55. Remove from Roster
      56. Request Presence Subscription
      57. Request Presence Unsubscription
      58. Search for Events
      59. Search
      60. Select Peer Review Provider
      61. Sell eDaler
      62. Send Chat Message
      63. Sign Smart Contract
      64. Update Binary File
      65. Update Roster Item
      66. Update Text File
    9. MCP Server Prompts
      1. Create eDaler
      2. Create Personal Legal Identity
      3. Destroy eDaler
      4. Find Sensitive Information
      5. Request Peer Review
      6. Transfer money
    10. MCP Server Resources
  2. Internet Content
  3. Event Log
  4. File Storage
  5. XMPP MCP Server
  6. Identity MCP Server
  7. Payments MCP Server
    1. JSON-RPC Interface
      1. initialize(ProtocolVersion, Capabilities, ClientInfo)
      2. notifications/initialized()
      3. prompts/get(Name, Arguments, _Meta)
      4. prompts/list(Cursor)
      5. resources/list(Cursor)
      6. resources/read(Uri, _Meta)
      7. resources/subscribe(Uri)
      8. resources/unsubscribe(Uri)
      9. tools/call(Name, Arguments, Task, _Meta)
      10. tools/list(Cursor)
    2. Types
      1. GenericResponse
      2. IdentityResponse
      3. PurchaseResponse
      4. ContractResponse
      5. UriResponse
      6. BalanceResponse
      7. OptionsResponse
      8. IdentityApplicationAttributesResponse
      9. MessageResponse
      10. PeerReviewProvidersResponse
      11. PendingPaymentsResponse
      12. ServiceProvidersResponse
      13. TransactionResponse
      14. PetitionResponse
      15. SearchResult
      16. SearchResult
      17. PromptMessage
      18. IdentityProperty
      19. IdentityAttachment
      20. Byte[]
      21. PeerReviewProvider
      22. PendingPaymentInformation
      23. ServiceProvider
      24. Event
      25. Byte[]
      26. Tag

MCP Server Interface

This MCP Server is accessible on this endpoint: https://lab.tagroot.io/MCP

The following subsections list MCP Server interfaces that are available on this resource. The MCP protocol is built on top of the JSON-RPC protocol. You find JSON-RPC interface below.

MCP Server Tools

Following subsections list MCP Server Tools that can be used to interact with the MCP Server.

Accept Presence Subscription

Accepts a presence subscription request from another user.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

AcceptPresenceSubscription(From)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Presence.Accept
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
From String Required - Bare JID of the sender of the presence subscription request to accept.
Return Value
Type Description
GenericResponse Results of operation.

Add Photo Attachment (BASE64 upload)

Adds a photo attachment to an identity application, by providing a BASE64-encoded binary of the photo together with its corresponding Content-Type.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

AddPhotoAttachmentBase64Upload(LegalId, Base64Photo, ContentTypePhoto, PhotoType)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Attachment.Add
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Legal Identity Identifier or Identity resource URI to which the attachment shall be added.
Base64Photo String Required - BASE64-encoded photo to be uploaded.
ContentTypePhoto String Required - Content-Type of the photo to be uploaded.
PhotoType PhotoType Optional "ProfilePhoto"

Type of photo to be uploaded. Possible values:

  • "ProfilePhoto" - Profile photo.
  • "Passport" - Photo of passport.
  • "IdCardFront" - Front of ID card.
  • "IdCardBack" - Back of ID card.
  • "DriverLicenseFront" - Front of Driver’s License.
  • "DriverLicenseBack" - Back of Driver’s License.
Return Value
Type Description
IdentityResponse Identity update result.

Add Photo Attachment (User Input)

Adds a photo attachment to an identity application, by eliciting the user for the photo.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

AddPhotoAttachmentElicitation(LegalId, PhotoType)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Attachment.Add
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Legal Identity Identifier or Identity resource URI to which the attachment shall be added.
PhotoType PhotoType Optional "ProfilePhoto"

Type of photo to be uploaded. Possible values:

  • "ProfilePhoto" - Profile photo.
  • "Passport" - Photo of passport.
  • "IdCardFront" - Front of ID card.
  • "IdCardBack" - Back of ID card.
  • "DriverLicenseFront" - Front of Driver’s License.
  • "DriverLicenseBack" - Back of Driver’s License.
Return Value
Type Description
IdentityResponse Identity update result.

Add Photo Attachment (URL Download)

Adds a photo attachment to an identity application, by providing a URL to the photo to be downloaded and then added as an attachment.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

AddPhotoAttachmentUrlDownload(LegalId, PhotoUrl, PhotoType)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Attachment.Add
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Legal Identity Identifier or Identity resource URI to which the attachment shall be added.
PhotoUrl URI Required - URL of the photo to be downloaded.
PhotoType PhotoType Optional "ProfilePhoto"

Type of photo to be uploaded. Possible values:

  • "ProfilePhoto" - Profile photo.
  • "Passport" - Photo of passport.
  • "IdCardFront" - Front of ID card.
  • "IdCardBack" - Back of ID card.
  • "DriverLicenseFront" - Front of Driver’s License.
  • "DriverLicenseBack" - Back of Driver’s License.
Return Value
Type Description
IdentityResponse Identity update result.

Add to Roster

Adds a contact to the roster of the XMPP account associated with the MCP Client.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

AddToRoster(BareJid, NickName, Groups)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Roster.Add
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
BareJid String Required - Bare JID of the contact to add to roster.
NickName String Optional null Optional nick name of the contact to add to roster.
Groups Array of String Optional null Optional groups to which the contact should be added.
Return Value
Type Description
GenericResponse Results of operation.

Append Binary File

Appends a binary file in account-specific file storage. If the file does not exist, one is created.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

AppendBinaryFile(LocalFileName, Content)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Append
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Content String Required - BASE-64 encoded binary content of file to append. The contents must not be harmful, be executable, or contain illegal information.
Return Value
Type Description
String URI of appended file resource.

Append Text File

Appends a text file in account-specific file storage. If the file does not exist, one is created. Text contents is stored UTF-8 encoded (with a Byte-Order-Mark (BOM) if the file is created).

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

AppendTextFile(LocalFileName, Content, AppendCrLf)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Append
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Content String Required - Text content of file to append. The contents must not be harmful or contain illegal information.
AppendCrLf Boolean Required - If true, a carriage-return/line-feed (CRLF) is appended to the text content before appending it to the file.
Return Value
Type Description
String URI of appended file resource.

Apply For New Personal Identity

Applies for a new personal identity. Personal information will be elicited from the user.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: No

ApplyForNewPersonalIdentity()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Apply
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
IdentityResponse Identity application result.

Buy eDaler

Buy eDaler using a service provider for buying eDaler.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

BuyEDaler(Id, Type, Amount, Currency)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Buy
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Id String Required - Service Provider ID for buying eDaler.
Type String Required - Service Provider Type for buying eDaler.
Amount Decimal-precision floating-point Required - Amount of eDaler to buy. [1,∞)
Currency String Required - Currency of the amount to buy.
Return Value
Type Description
PurchaseResponse Amount of eDaler bought.

Compromise Identity

Reports one of the identities or identity applications registered by the user as compromised.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: No

CompromiseIdentity(LegalId)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Compromise
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Legal Identity Identifier or Identity resource URI to report as compromised.
Return Value
Type Description
IdentityResponse Identity compromised report result.

Create Binary File

Creates a binary file in account-specific file storage. If a file with the same name exists, it is replaced.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

CreateBinaryFile(LocalFileName, Content)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Content String Required - BASE-64 encoded binary content of file to create. The contents must not be harmful, be executable, or contain illegal information.
Return Value
Type Description
String URI of created file resource.

Create Open Smart Contract

Creates a new open smart contract, based on a contract template. (Open means parts are not predefined.)

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

CreateOpenContract(TemplateId, Parameters, Visibility, DurationDays, ArchiveRequiredDays, ArchiveOptionalDays, SignAfter, SignBefore)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Contract.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
TemplateId String Required - Identifier of the Smart Contract template to use as basis for the new smart contract.
Parameters Dictionary Required - Dictionary object of parameter values to use for the contract. The parameters must be defined in the contract template, and the values must be valid in accordance with validation rules defined in the contract template.
Visibility ContractVisibility Required -

Visibility of created contract. Possible values:

  • "CreatorAndParts" - Creator and Parts
  • "DomainAndParts" - Domain
  • "Public" - Public
  • "PublicSearchable" - Public and Searchable
DurationDays 32-bit signed integer Required - Duration of contracts, once signed, as a number of days. [1,∞)
ArchiveRequiredDays 32-bit signed integer Optional 365 Required archiving time, once contract expires, as a number of days. [0,∞)
ArchiveOptionalDays 32-bit signed integer Optional 0 Optional archiving time, once contract expires, as a number of days. [0,∞)
SignAfter Nullable Date & Time Optional null Signatures will only be accepted after this point in time, if defined. (∞,∞)
SignBefore Nullable Date & Time Optional null Signatures will only be accepted before this point in time, if defined. (∞,∞)
Return Value
Type Description
ContractResponse Result of operation.

Create Open Payment URI

Creates an open eDaler payment URI. The party that claims the URI and sends it to its Neuron, will receive the eDaler.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

CreateOpenPaymentUri(Amount, AmountExtra, ValidNrDays)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Amount Decimal-precision floating-point Required - Amount of eDaler to transfer. [0.01,∞)
AmountExtra Nullable Decimal-precision floating-point Optional 0.0 Optional extra amount of eDaler to transfer. [0,∞)
ValidNrDays 32-bit signed integer Optional 3 Number of days the URI is valid. [1,∞)
Return Value
Type Description
UriResponse Payment URI.

Create Payment URI to Bare JID

Creates an eDaler payment URI to a specific Bare JID. Regardless of who claims the URI and sends it to its Neuron, the transfer will be made to the wallet belonging to the account identified by the Bare JID.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

CreatePaymentToBareJidUri(RecipientBareJid, Amount, AmountExtra, ValidNrDays, Message, ConditionalContractId)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
RecipientBareJid String Required - Bare JID of recipient.
Amount Decimal-precision floating-point Required - Amount of eDaler to transfer. [0.01,∞)
AmountExtra Nullable Decimal-precision floating-point Optional 0.0 Optional extra amount of eDaler to transfer. [0,∞)
ValidNrDays 32-bit signed integer Optional 3 Number of days the URI is valid. [1,∞)
Message String Optional "" Optional message to include in the payment URI.
ConditionalContractId String Optional null Optional Contract ID for conditional payments. A payment can only be performed, if this contract is fully signed.
Return Value
Type Description
UriResponse Payment URI.

Create Payment URI to Legal ID

Creates an eDaler payment URI to a specific Legal ID. Regardless of who claims the URI and sends it to its Neuron, the transfer will be made to the wallet belonging to the account identified by the Legal ID. The sender must also have access to the Legal ID for the transfer to be made.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

CreatePaymentToLegalIdUri(RecipientLegalId, Amount, AmountExtra, ValidNrDays, PrivateMessage, ConditionalContractId)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
RecipientLegalId String Required - Identifier of Legal ID of recipient.
Amount Decimal-precision floating-point Required - Amount of eDaler to transfer. [0.01,∞)
AmountExtra Nullable Decimal-precision floating-point Optional 0.0 Optional extra amount of eDaler to transfer. [0,∞)
ValidNrDays 32-bit signed integer Optional 3 Number of days the URI is valid. [1,∞)
PrivateMessage String Optional "" Optional private message to include in the payment URI. The message will be encrypted using the public Legal Identity of the recipient.
ConditionalContractId String Optional null Optional Contract ID for conditional payments. A payment can only be performed, if this contract is fully signed.
Return Value
Type Description
UriResponse Payment URI.

Create Pay-Me URI

Creates an eDaler pay-me URI that can be shared with others to request payment. Regardless of who then claims the URI and sends it to its Neuron, the transfer will be made to your wallet.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

CreatePayMeUri(Amount, AmountExtra, Message, EncryptMessage)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Amount Nullable Decimal-precision floating-point Required - Optional amount of eDaler to transfer. [0,∞)
AmountExtra Nullable Decimal-precision floating-point Optional 0.0 Optional extra amount of eDaler to transfer. [0,∞)
Message String Optional "" Optional message to include in the pay-me URI.
EncryptMessage Boolean Optional false If the message to include in the pay-me URI should be encrypted.
Return Value
Type Description
UriResponse Pay-me URI.

Create Text File

Creates a text file in account-specific file storage. If a file with the same name exists, it is replaced. Text contents is stored UTF-8 encoded, with a Byte-Order-Mark (BOM).

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

CreateTextFile(LocalFileName, Content, AppendCrLf)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Content String Required - Text content of file to create. The contents must not be harmful or contain illegal information.
AppendCrLf Boolean Required - If true, a carriage-return/line-feed (CRLF) is appended to the text content before creating the file.
Return Value
Type Description
String URI of created file resource.

Decline Presence Subscription

Declines a presence subscription request from another user.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

DeclinePresenceSubscription(From)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Presence.Decline
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
From String Required - Bare JID of the sender of the presence subscription request to decline.
Return Value
Type Description
GenericResponse Results of operation.

Delete

Deletes content from the Internet, by accessing a resource using the DELETE method.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: Yes

Delete(Uri, Accept, AcceptLanguage, Timeout, AdditionalHeaders)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.InternetContent.Tools.Delete
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to access.
Accept String Optional "*/*" Accept header to use when accessing the resource. It informs the web server what Internet Content-Type you are expecting the content of the response to be encoded with.
AcceptLanguage String Optional "" Optional Accept-Language header to use when accessing the resource. It informs the web server what language you expect human-readable content to be written in.
Timeout 32-bit signed integer Optional 30000 Timeout in milliseconds for the request. [1,60000]
AdditionalHeaders Dictionary Optional null Additional headers to include in the request.
Return Value
Type Description
Custom Encoding Internet content received.

Delete File

Deletes a file in account-specific file storage, regardless of type. The file must exist.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: No

DeleteFile(LocalFileName)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Delete
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Return Value
Type Description
String URI of deleted file resource.

Edit

Edits a file in account-specific file storage.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: No

EditFile(LocalFileName, Sensitive)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Edit
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Sensitive Boolean Required - If the contents of the file are sensitive, set this to true. Sensitive information will be edited in a separate protected window and not inline.
Return Value
Type Description
String URI of updated file resource.

Get

Retrieves content from the Internet, by accessing a resource using the GET method.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: Yes

Get(Uri, Accept, AcceptLanguage, Timeout, AdditionalHeaders)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.InternetContent.Tools.Get
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to access.
Accept String Optional "*/*" Accept header to use when accessing the resource. It informs the web server what Internet Content-Type you are expecting the content of the response to be enceded with.
AcceptLanguage String Optional "" Optional Accept-Language header to use when accessing the resource. It informs the web server what language you expect human-readable content to be written in.
Timeout 32-bit signed integer Optional 30000 Timeout in milliseconds for the request. [1,60000]
AdditionalHeaders Dictionary Optional null Additional headers to include in the request.
Return Value
Type Description
Custom Encoding Internet content received.

Get Balance

Gets the current eDaler balance of the wallet.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

GetBalance()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Balance.Get
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
BalanceResponse Current balance.

Get Options for Buying eDaler

Gets available options for buying eDaler.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: Yes

GetBuyEDalerOptions(Id, Type)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Buy
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Id String Required - Service Provider ID for buying eDaler.
Type String Required - Service Provider Type for buying eDaler.
Return Value
Type Description
OptionsResponse Options for buying eDaler.

Get Identity Application Properties

Gets identity application properties recommended by the server should be available in identity applications.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

GetIdentityApplicationProperties()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Apply
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
IdentityApplicationAttributesResponse Identity application attributes.

Get Message

Gets a message that has been received over XMPP.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: Yes

GetMessage(MessageId, Remove)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Message.Get
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
MessageId String Required - The ID of the message to retrieve. Can be the identifier itself, or the message resource URI.
Remove Boolean Optional false Determines if the message should be removed from the list of received messages or not.
Return Value
Type Description
MessageResponse Message, if found.

Get Peer Review Providers

Gets a list of peer review providers that can be used to review identity applications.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

GetPeerReviewProviders()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Petition.PeerReview
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
PeerReviewProvidersResponse Available peer review providers.

Get Pending Payments

Gets a list of payments that are pending to be processed.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

GetPendingPayments()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Pending.Get
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
PendingPaymentsResponse Information about pending payments.

Get Options for Selling eDaler

Gets available options for selling eDaler.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: Yes

GetSellEDalerOptions(Id, Type)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Sell
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Id String Required - Service Provider ID for selling eDaler.
Type String Required - Service Provider Type for selling eDaler.
Return Value
Type Description
OptionsResponse Options for selling eDaler.

Get Service Providers for Buying eDaler

Gets a list of service providers that can be used to buy eDaler.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

GetServiceProvidersForBuyingEDaler()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Buy
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
ServiceProvidersResponse Available service providers for buying eDaler.

Get Service Providers for Selling eDaler

Gets a list of service providers that can be used to sell eDaler.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

GetServiceProvidersForSellingEDaler()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Sell
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
ServiceProvidersResponse Available service providers for selling eDaler.

Log Alert Event

Logs an alert event to the event log. An alert error is so grave, that action must be taken immediately. Logged alert events also get propagated to operators immediately.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogAlert(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Alert
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Critical Error Event

Logs a critical error event to the event log. A critical error is an error so great that it could escalate into something graver if not addressed. Typically, a Critical error is typically an unexpected error.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogCritical(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Critical
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Debug Event

Logs an event for debug purposes to the event log. The purpose of debug events is to highlight technical information to developers, for troubleshooting.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogDebug(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Debug
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Emergency Event

Logs an emergency event to the event log. An emergency error signals the system is unusable, or will become unusable if action is not taken immediately. Logged emergency events also get propagated to operators immediately.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogEmergency(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Emergency
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Error Event

Logs an error event to the event log. Error events inform operators of normal error conditions. A normal error condition is typically an expected error.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogError(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Error
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Informational Event

Logs an informational event to the event log. The purpose of informational events is to provide a record of normal operational tasks being performed or events occurring.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogInformational(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Information
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Notice Event

Logs an notice event to the event log. A Notice represents a significant condition or change that administrators should be aware of.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogNotice(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Notice
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Log Warning Event

Logs a warning event to the event log. Warning events warn operators of conditions that may lead to errors if they are not properly managed.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

LogWarning(Message, Object, Actor, Level, EventId, Facility, Module)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Log.Warning
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Message String Required - The body text of the logged event.
Object String Optional "" The object associated with the event, if any.
Actor String Optional "" The subject, or actor, performing the action resulting in the event being logged.
Level EventLevel Optional "Minor"

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
EventId String Optional "McpEvent" Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String Optional "" The subsystem or external component that is the source of the event.
Module String Optional "" The module or component within the source that is the source of the event.

Obsolete Identity

Obsoletes one of the identities or identity applications registered by the user.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: No

ObsoleteIdentity(LegalId)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Obsolete
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Legal Identity Identifier or Identity resource URI to obsolete.
Return Value
Type Description
IdentityResponse Identity obsoletion result.

Make Payment to Bare JID

Makes an eDaler payment to the wallet belonging to the account identified by the Bare JID.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

PayToBareJid(RecipientBareJid, Amount, AmountExtra, ValidNrDays, Message)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Create, OAUTH.Scope.MCP.Payments.Tools.Uri.Process
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
RecipientBareJid String Required - Bare JID of recipient.
Amount Decimal-precision floating-point Required - Amount of eDaler to transfer. [0.01,∞)
AmountExtra Nullable Decimal-precision floating-point Optional 0.0 Optional extra amount of eDaler to transfer. [0,∞)
ValidNrDays 32-bit signed integer Optional 3 Number of days the URI is valid. [1,∞)
Message String Optional "" Optional message to include in the payment URI.
Return Value
Type Description
TransactionResponse Transaction information.

Make Payment to Legal ID

Makes an eDaler payment to the wallet belonging to the account identified by the Legal ID. The sender must also have access to the Legal ID for the transfer to be made.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

PayToLegalId(RecipientLegalId, Amount, AmountExtra, ValidNrDays, PrivateMessage)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Create
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
RecipientLegalId String Required - Identifier of Legal ID of recipient.
Amount Decimal-precision floating-point Required - Amount of eDaler to transfer. [0.01,∞)
AmountExtra Nullable Decimal-precision floating-point Optional 0.0 Optional extra amount of eDaler to transfer. [0,∞)
ValidNrDays 32-bit signed integer Optional 3 Number of days the URI is valid. [1,∞)
PrivateMessage String Optional "" Optional private message to include in the payment URI. The message will be encrypted using the public Legal Identity of the recipient.
Return Value
Type Description
TransactionResponse Transaction information.

Petition Legal Identity

Sends a petition to a user for one of its legal identities.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

PetitionLegalIdentity(LegalId, Purpose)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Petition.Identity
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Identifier of Legal Identity to petition.
Purpose String Required - A message to the recipient of the petition, explaining the purpose of the petition.
Return Value
Type Description
PetitionResponse Result of operation.

Petition Peer Review

Sends a petition to a peer for a review of an identity application.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

PetitionPeerReview(LegalId, Purpose)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Petition.PeerReview
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Identifier of Legal Identity to send the petition to.
Purpose String Required - Message to recipient of petition, explaining the purpose of the review.
Return Value
Type Description
PetitionResponse Result of operation.

Petition Digital Signature

Sends a petition to a user for a digital signature.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

PetitionSignature(LegalId, Content, Purpose)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Petition.Signature
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Identifier of Legal Identity to petition.
Content String Required - BASE64-encoded content to sign.
Purpose String Required - A message to the recipient of the petition, explaining the purpose of the petition.
Return Value
Type Description
PetitionResponse Result of operation.

Petition Smart Contract

Sends a petition to the parts of a smart contract, for access to the smart contract.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

PetitionSmartContract(ContractId, Purpose)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Petition.Contract
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
ContractId String Required - Identifier of the Smart Contract to petition.
Purpose String Required - A message to the recipients of the petition, explaining the purpose of the petition.
Return Value
Type Description
PetitionResponse Result of operation.

Pop Message

Gets the first message that has been received over XMPP, and then removes it from the resource list.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: Yes

PopMessage()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Message.Get
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
MessageResponse Message, if found.

Post

Posts information to a resource on the Internet using the POST method, and returns the content that is returned.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: Yes

Post(Uri, Payload, Accept, AcceptLanguage, Timeout, AdditionalHeaders)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.InternetContent.Tools.Post
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to access.
Payload Object Optional null The payload to post to the resource.
Accept String Optional "*/*" Accept header to use when accessing the resource. It informs the web server what Internet Content-Type you are expecting the content of the response to be enceded with.
AcceptLanguage String Optional "" Optional Accept-Language header to use when accessing the resource. It informs the web server what language you expect human-readable content to be written in.
Timeout 32-bit signed integer Optional 30000 Timeout in milliseconds for the request. [1,60000]
AdditionalHeaders Dictionary Optional null Additional headers to include in the request.
Return Value
Type Description
Custom Encoding Internet content response received.

Process Payment URI

Sends an eDaler URI to the Neuron for processing.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

ProcessPaymentUri(Uri)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.Uri.Process
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Uri URI Required - eDaler URI to send to the Neuron for processing.
Return Value
Type Description
TransactionResponse Transaction information.

Propose Smart Contract

Sends a proposal to sign a smart contract as a specific role.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

ProposeContract(ContractId, Role, To, Message)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Contract.Propose
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
ContractId String Required - Identifier of the Smart Contract to propose.
Role String Required - Role to propose.
To String Required - Bare JID of recipient of proposal.
Message String Required - Message to show the recipient of the proposal.
Return Value
Type Description
GenericResponse Result of operation.

Put

Puts information to a resource on the Internet using the PUT method, and returns the content that is returned.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: Yes
Open World Access: Yes

Put(Uri, Payload, Accept, AcceptLanguage, Timeout, AdditionalHeaders)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.InternetContent.Tools.Put
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to access.
Payload Object Optional null The payload to put to the resource.
Accept String Optional "*/*" Accept header to use when accessing the resource. It informs the web server what Internet Content-Type you are expecting the content of the response to be encoded with.
AcceptLanguage String Optional "" Optional Accept-Language header to use when accessing the resource. It informs the web server what language you expect human-readable content to be written in.
Timeout 32-bit signed integer Optional 30000 Timeout in milliseconds for the request. [1,60000]
AdditionalHeaders Dictionary Optional null Additional headers to include in the request.
Return Value
Type Description
Custom Encoding Internet content response received.

Query

Queries information from a resource on the Internet using the QUERY method, and returns the content that is returned.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: Yes

Query(Uri, Payload, Accept, AcceptLanguage, Timeout, AdditionalHeaders)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.InternetContent.Tools.Query
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to access.
Payload Object Optional null The payload to send in the query to the resource.
Accept String Optional "*/*" Accept header to use when accessing the resource. It informs the web server what Internet Content-Type you are expecting the content of the response to be encoded with.
AcceptLanguage String Optional "" Optional Accept-Language header to use when accessing the resource. It informs the web server what language you expect human-readable content to be written in.
Timeout 32-bit signed integer Optional 30000 Timeout in milliseconds for the request. [1,60000]
AdditionalHeaders Dictionary Optional null Additional headers to include in the request.
Return Value
Type Description
Custom Encoding Internet content response received.

Ready For Approval Identity

Reports one of the identities or identity applications registered by the user as ready for approval.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: No

ReadyForApproval(LegalId)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.ReadyForApproval
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LegalId String Required - Legal Identity Identifier or Identity resource URI to report as ready for approval.
Return Value
Type Description
GenericResponse Identity report result.

Remove Attachment

Removes an attachment from an identity application.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

RemoveAttachment(AttachmentId)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Attachment.Remove
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
AttachmentId String Required - Attachment ID to be removed.
Return Value
Type Description
IdentityResponse Identity update result.

Remove from Roster

Removes a contact from the roster of the XMPP account associated with the MCP Client.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: No
Open World Access: Yes

RemoveFromRoster(BareJid)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Roster.Remove
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
BareJid String Required - Bare JID of the contact to remove from roster.
Return Value
Type Description
GenericResponse Results of operation.

Request Presence Subscription

Requests a presence subscription to another user's presence.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: Yes
Open World Access: Yes

RequestPresenceSubscription(To)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Presence.Subscribe
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
To String Required - Bare JID of the user to whom send a presence subscription request.
Return Value
Type Description
GenericResponse Results of operation.

Request Presence Unsubscription

Requests a presence unsubscription from another user's presence.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: Yes
Open World Access: Yes

RequestPresenceUnsubscription(To)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Presence.Unsubscribe
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
To String Required - Bare JID of the user to whom send a presence subscription request.
Return Value
Type Description
GenericResponse Results of operation.

Search for Events

Performs a search for events in the event log.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: No

Search(Offset, MaxCount, From, To, Message, Object, Actor, EventId, Module, Facility, Debug, Informational, Notice, Warning, Error, Critical, Alert, Emergency, Minor, Medium, Major)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Tools.Search
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Offset 32-bit signed integer Optional 0 Offset into search result set where returned events begin. [0,2147483647]
MaxCount 32-bit signed integer Optional 100 Maximum number of results to return. [1,1000]
From Nullable Date & Time Optional null Start date/time for search, in UTC. If provided, only events newer than or equal to this point in time will be returned. (∞,∞)
To Nullable Date & Time Optional null End date/time for search, in UTC. If provided, only events older than or equal to this point in time will be returned. (∞,∞)
Message String Optional null Message to search for. If provided, only events containing this message text will be returned.
Object String Optional null Object to search for. If provided, only events with this object will be returned. This property represents the object associated with the events.
Actor String Optional null Actor to search for. If provided, only events with this actor will be returned. This property represents the subject, or actor, performing the action resulting in the events being logged.
EventId String Optional null Event ID to search for. If provided, only events with this event ID will be returned. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Module String Optional null Module ID to search for. If provided, only events with this module will be returned. This property represents the module or component within the source that is the source of the event.
Facility String Optional null Facility ID to search for. If provided, only events with this facility will be returned. this property represents the subsystem or external component that is the source of the event.
Debug Nullable Boolean Optional null If provided, determines if debug events are to be included in the result. The purpose of debug events is to highlight technical information to developers, for troubleshooting.
Informational Nullable Boolean Optional null If provided, determines if informational events are to be included in the result. The purpose of informational events is to provide a record of normal operational tasks being performed or events occurring.
Notice Nullable Boolean Optional null If provided, determines if notice events are to be included in the result. A Notice represents a significant condition or change that administrators should be aware of.
Warning Nullable Boolean Optional null If provided, determines if warning events are to be included in the result. Warning events warn operators of conditions that may lead to errors if they are not properly managed.
Error Nullable Boolean Optional null If provided, determines if error events are to be included in the result. Error events inform operators of normal error conditions. A normal error condition is typically an expected error.
Critical Nullable Boolean Optional null If provided, determines if critical error events are to be included in the result. A critical error is an error so great that it could escalate into something graver if not addressed. Typically, a Critical error is typically an unexpected error.
Alert Nullable Boolean Optional null If provided, determines if alerts events are to be included in the result. An alert error is so grave, that action must be taken immediately.
Emergency Nullable Boolean Optional null If provided, determines if emergencies events are to be included in the result. An emergency error signals the system is unusable, or will become unusable if action is not taken immediately.
Minor Nullable Boolean Optional null If provided, determines if minor events are to be included in the result. Minor events occur frequently.
Medium Nullable Boolean Optional null If provided, determines if medium events are to be included in the result. Medium events update something, or reports something could cause a major event.
Major Nullable Boolean Optional null If provided, determines if major events are to be included in the result. Major events adds or destroys something, or reports something important is out of order.
Return Value
Type Description
SearchResult Result set of the search for events, as well as information about if more events are available, and the offset to the next set of events.

Searches for files in account-specific file storage that have file names matching a given search pattern.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

SearchFiles(Pattern)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Search
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Pattern String Optional "*.*" File name search pattern. Must not contain double period characters or path characters, to attempt to escape file storage area. Use asterisk (*) as wildcard, or questionmark (?) as a character wildcard.
Return Value
Type Description
SearchResult Search result of files in account-specific file storage.

Select Peer Review Provider

Selects an internal Peer Review provider.

Properties
Can Modify: No
Can Destroy: No
Is Idempotent: Yes
Open World Access: No

SelectPeerReviewProvider(Id, Type)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Petition.PeerReview
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Id String Required - Peer Review Provider ID.
Type String Required - Peer Review Provider Type.
Return Value
Type Description
GenericResponse Result of operation.

Sell eDaler

Sell eDaler using a service provider for selling eDaler.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

SellEDaler(Id, Type, Amount, Currency)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Sell
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
Id String Required - Service Provider ID for selling eDaler.
Type String Required - Service Provider Type for selling eDaler.
Amount Decimal-precision floating-point Required - Amount of eDaler to sell. [1,∞)
Currency String Required - Currency of the amount to sell.
Return Value
Type Description
PurchaseResponse Amount of eDaler sold.

Send Chat Message

Sends a Chat Message to a recipient using XMPP.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

SendChatMessage(To, Message, IsMarkdown, Language)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Message.Send
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
To String Required - Bare JID of the recipient of the message.
Message String Required - Message content. Can be either plain text, or Markdown.
IsMarkdown Boolean Optional false Indicates if the message is in Markdown format (true), or plain text (false).
Language String Optional null Optional ISO-639 code of language used in the message, if any.
Return Value
Type Description
GenericResponse Results of operation.

Sign Smart Contract

Signs a smart contract as a specific role.

Properties
Can Modify: Yes
Can Destroy: No
Is Idempotent: No
Open World Access: Yes

SignContract(ContractId, Role, Transferable)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Tools.Contract.Sign
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
ContractId String Required - Identifier of the Smart Contract to sign.
Role String Required - Role to sign the contract as.
Transferable Boolean Optional false If the signature is transferable to another party during the life cycle of the contract.
Return Value
Type Description
ContractResponse Result of operation.

Update Binary File

Updates a binary file in account-specific file storage. The file must exist.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: Yes
Open World Access: No

UpdateBinaryFile(LocalFileName, Content)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Update
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Content String Required - BASE-64 encoded binary content of file to update. The contents must not be harmful, be executable, or contain illegal information.
Return Value
Type Description
String URI of updated file resource.

Update Roster Item

Updates a contact in the roster of the XMPP account associated with the MCP Client.

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: Yes
Open World Access: Yes

UpdateRosterItem(BareJid, NickName, Groups)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.XMPP.Tools.Roster.Update
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
BareJid String Required - Bare JID of the contact to update in roster.
NickName String Optional null Optional nick name of the contact to update in roster.
Groups Array of String Optional null Optional groups to which the contact should belong.
Return Value
Type Description
GenericResponse Results of operation.

Update Text File

Updates a text file in account-specific file storage, replacing its previous content with new content. The file must exist. Text contents is stored UTF-8 encoded, with a Byte-Order-Mark (BOM).

Properties
Can Modify: Yes
Can Destroy: Yes
Is Idempotent: Yes
Open World Access: No

UpdateTextFile(LocalFileName, Content, AppendCrLf)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Files.Tools.Update
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
LocalFileName String Required - Local file name. Must not contain double period characters or begin with a path character, to attempt to escape file storage area. File extension must match Internet Content-Type of file contents.
Content String Required - Text content of file to update. The contents must not be harmful or contain illegal information.
AppendCrLf Boolean Required - If true, a carriage-return/line-feed (CRLF) is appended to the text content before updating the file.
Return Value
Type Description
String URI of updated file resource.

MCP Server Prompts

Following subsections list MCP Server Prompts that can be used to interact with the MCP Server.

Create eDaler

Creates new eDaler in the wallet of the user.

CreateEDaler()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Buy
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
Array of PromptMessage

Create Personal Legal Identity

Creates a new Legal Personal Identity for the user.

CreatePersonalLegalIdentity()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Prompts.Create.Create.PersonalId
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
Array of PromptMessage

Destroy eDaler

Destroys existing eDaler in the wallet of the user.

DestroyEDaler()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Sell
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
Array of PromptMessage

Find Sensitive Information

Search for events in the event log containing sensitive information that should never have been logged.

FindSensitiveInformation(NrDays, FindSuspectActivity, FindIntrusions, FindResourceDepletion, FindCredentials, FindKeys, FindSensitivePersonalInformation, ReportEventsFound, EditEvents, DeleteEvents)

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.EventLog.Prompts.FindSensitiveInfo
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Arguments
Name Type Use Default Value Description
NrDays 32-bit signed integer Optional 7 Number of days back in time the search for events should be performed. (∞,∞)
FindSuspectActivity Boolean Optional true If true, the search will look for activity that is suspicious.
FindIntrusions Boolean Optional true If true, the search will look for evidence of intrusions.
FindResourceDepletion Boolean Optional true If true, the search will look for evidence of resources being depleted, or being close to be depleted.
FindCredentials Boolean Optional true If true, the search will look for credentials in the events.
FindKeys Boolean Optional true If true, the search will look for keys in the events.
FindSensitivePersonalInformation Boolean Optional true If true, the search will look for sensitive personal information in the events.
ReportEventsFound Boolean Optional true If true, the search will generate a report of all events containing sensitive information found during the search.
EditEvents Boolean Optional false If true, the events found will be edited accordingly, to remove the sensitive information.
DeleteEvents Boolean Optional false If true, the events found that cannot be edited, will be deleted accordingly, to remove the sensitive information and associated information in the associated event.
Return Value
Type Description
Array of PromptMessage

Request Peer Review

Requests a Peer Review of a current Identity Application.

RequestPeerReview()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Identity.Prompts.Create.Create.PersonalId, OAUTH.Scope.MCP.Identity.Tools.Petition.PeerReview
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
Array of PromptMessage

Transfer money

Transfers money to someone else.

TransferMoney()

Authentication
Required: Yes
Privileges Required: OAUTH.Scope.MCP.Payments.Tools.EDaler.Buy, OAUTH.Scope.MCP.Payments.Tools.EDaler.Sell
Authentication Mechanisms: Bearer JWT (128+ bit Encryption), Basic (128+ bit Encryption), Digest-MD5 (128+ bit Encryption), Digest-SHA-256 (128+ bit Encryption), Digest-SHA-3-256 (128+ bit Encryption), Session
Return Value
Type Description
Array of PromptMessage

MCP Server Resources

This MCP Server supports MCP Server Resources.

Following are information regarding resources published by the different MCP Servers available via this MCP server.

Internet Content

Event Log

File Storage

Each resource represents a file in the account-specific file storage. As files are created, modified, renamed or deleted, resource events are propagated to clients that receive notifications (new, renamed or deleted files) or have resource subscriptions active (modifed files).

Note: Files are account-specific. This means that other clients have different sets of files. This means that URIs cannot be meaningfully shared, as they point to different files in each account-specific storage. The purpose of the account-specific storage is to store information for later processing or reference.

XMPP MCP Server

There are different types of resources published by the XMPP MCP Server. The type of resource is identified by the URI scheme of each resource.

The xmpp URI scheme represents a contact in the account-specific roster. Read the resource to gain information about what groups the contact belongs to, and the status of presence subscriptions, as well as nick names and last published presence information.

Note: Rosters are account-specific. When working with XMPP each MCP Client gets associated with an XMPP account. The roster belongs to the XMPP account. Different MCP Clients have their separate rosters. Resources can be shared between MCP clients however, as they only point to the different contacts. When different clients read the resources however, different responses are expected.

The mid URI scheme represents a message stanza that has been received. Read the resource, pop the message from the queue, and read it. Once the message has been read, it will be removed from the resource list. If the MCP client needs to store it, it can use file persistence to store the contents of the resource.

Note: Messages are not persisted by the MCP Server. It is the responsability of the MCP Client to read incoming messages and store them if necessary.

Identity MCP Server

Resources on the MCP server represents digital identities in their various states, or petitioned smart contracts, or contract templates you have used.

Each identity has a State, a date when it was Created, a date when it was last Updated, a date from when the identity is valid to be used and a To date until when it is valid and after which it expires.

Each smart contract, or smart contract temaplte is recognized by the use of the iotsc URI scheme. Each smart contract has a State, a date when it was Created, a date when it was last updated, a duration, roles, parts who have signed the contract, parameters and human-readable and machine-readable contents.

Payments MCP Server

Resources on the MCP server represents transactions that have been performed. Each transaction lists timestamp, change balance, remote endpoint, and an optional message. If the message was sent in encrypted form, the message is decrypted, if possible. If not possible to decrypt, the encrypted message is available, together with the public key for which the encryption was made, and a decryption error message.

JSON-RPC Interface

This JSON-RPC Web Service is accessible on this endpoint: https://lab.tagroot.io/MCP

The following subsections list JSON-RPC methods that are available on this resource.

initialize(ProtocolVersion, Capabilities, ClientInfo)

MCP initialize method. Called by client to initialize connection and exchange information about capabilities.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
ProtocolVersion String Required - Protocol Version
Capabilities Dictionary Required - Client capabilities
ClientInfo Dictionary Required - Client information
Return Value
Type Description
Dictionary Server capabilities and information.

notifications/initialized()

Notification that the client has completed its initialization.

Authentication
Required: No

prompts/get(Name, Arguments, _Meta)

Gets an MCP server prompt.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Name String Required - Name of the prompt to call.
Arguments Dictionary Required - Arguments for the prompt.
_Meta Object Optional null Associated meta-data, if available.
Return Value
Type Description
Dictionary Dictionary containing the prompt.

prompts/list(Cursor)

Lists available MCP server prompts.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Cursor String Optional null Cursor for pagination.
Return Value
Type Description
Dictionary Dictionary containing the list of prompts.

resources/list(Cursor)

Lists available MCP server resources.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Cursor String Optional null Cursor for pagination.
Return Value
Type Description
Dictionary Dictionary containing the list of resources.

resources/read(Uri, _Meta)

Reads an MCP server resource.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to read.
_Meta Object Optional null Associated meta-data, if available.
Return Value
Type Description
Dictionary Dictionary containing the contents of the resource.

resources/subscribe(Uri)

Subscribes to an MCP server resource.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to subscribe to.

resources/unsubscribe(Uri)

Unsubscribes from an MCP server resource.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Uri URI Required - URI of the resource to unsubscribe from.

tools/call(Name, Arguments, Task, _Meta)

Calls an MCP server tool.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Name String Required - Name of the tool to call.
Arguments Dictionary Required - Arguments for the tool.
Task Object Optional null

If specified, the caller is requesting task-augmented execution for this request. The request will return a CreateTaskResult immediately, and the actual result can be retrieved later via tasks/result.

Task augmentation is subject to capability negotiation - receivers MUST declare support for task augmentation of specific request types in their capabilities.

_Meta Object Optional null Associated meta-data, if available.
Return Value
Type Description
Dictionary Dictionary containing the result of the tool call.

tools/list(Cursor)

Lists available MCP server tools.

Authentication
Required: No
Arguments
Name Type Use Default Value Description
Cursor String Optional null Cursor for pagination.
Return Value
Type Description
Dictionary Dictionary containing the list of tools.

Types

This Web Service encodes named types as JSON dictionary objects. The following subsections list the named typed and their corresponding properties.

GenericResponse

Properties
Name Type Description
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

IdentityResponse

Properties
Name Type Description
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.
Id String Identifier of the identity.
Provider String Trust Provider of the identity.
State Nullable IdentityState

State of the identity. Possible values:

  • "Created" - Created
  • "Approved" - Approved
  • "Rejected" - Rejected
  • "Obsoleted" - Obsoleted
  • "Compromised" - Compromised
Created Nullable Date & Time Date and time when the identity was created. (∞,∞)
Updated Nullable Date & Time Date and time when the identity was last updated. (∞,∞)
From Nullable Date & Time Date when the identity becomes valid. (∞,∞)
To Nullable Date & Time Date when the identity becomes invalid. (∞,∞)
Properties Array of IdentityProperty Conceptual properties associated with the digital identity.
Attachments Array of IdentityAttachment Attachments associated with the digital identity.
ClientKeyName String Name of the client key used to sign the request.
ClientPubKey BASE64-encoded binaryByte[] Public key of the client, used to sign the request.
ClientSignature BASE64-encoded binaryByte[] Signature of the request, generated by the client.

PurchaseResponse

Properties
Name Type Description
Amount Nullable Decimal-precision floating-point Amount of eDaler (∞,∞)
Currency String Currency of amount
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

ContractResponse

Properties
Name Type Description
Contract Dictionary Current state of smart contract.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

UriResponse

Properties
Name Type Description
Uri URI Payment URI.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

BalanceResponse

Properties
Name Type Description
Timestamp Nullable Date & Time Timestamp of balance. (∞,∞)
Amount Nullable Decimal-precision floating-point Amount at given point in time. (∞,∞)
Reserved Nullable Decimal-precision floating-point Reserved amount, that the user cannot use directly. (∞,∞)
Currency String Currency of amount.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

OptionsResponse

Properties
Name Type Description
Options Array of Dictionary Available options the user can select from.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

IdentityApplicationAttributesResponse

Properties
Name Type Description
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.
PeerReview Nullable Boolean If peer-review is allowed as a mechanism to approve ID applications.
NrReviewers Nullable 32-bit signed integer Number of peer reviewers required to get an ID approved using peer review. [0,∞)
NrPhotos Nullable 32-bit signed integer Number of photos required in a peer-review. [0,∞)
Iso3166 Nullable Boolean If ISO 3166 country codes are mandated in peer-review.
RequiredProperties Array of String Required properties in an ID application for peer-review.

MessageResponse

Properties
Name Type Description
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.
From String Full JID of sender of message.
FromBareJid String Bare JID of sender of message.
To String Full JID of recipient of message.
Body String Plain text body of message.
Type Nullable MessageType

Type of message. Possible values:

  • "Chat" - The message is sent in the context of a one-to-one chat session.
  • "Error" - The message is generated by an entity that experiences an error when processing a message
  • "GroupChat" - The message is sent in the context of a multi-user chat environment
  • "Headline" - The message provides an alert, a notification, or other transient information to which no reply is expected
  • "Normal" - The message is a standalone message whose purpose is defined by its XML contents.
Subject String Subject of message, if available.
ThreadID String Thread ID of message, if available.
ParentThreadID String Parent thread ID of message, if available.
ContentXml String XML content embedded in message, if available.
ErrorMessage Nullable Boolean If the message retrieved is an error message.
ErrorMessageCode Nullable 32-bit signed integer Error code of error message, if available. (∞,∞)
ErrorMessageType Nullable ErrorType

Error type of error message, if available. Possible values:

  • "None" - No error
  • "Auth" - Retry after providing credentials
  • "Cancel" - Do not retry (the error cannot be remedied)
  • "Continue" - Proceed (the condition was only a warning)
  • "Modify" - Retry after changing the data sent
  • "Wait" - Retry after waiting (the error is temporary)
  • "Undefined" - Undefined error type
ErrorMessageText String Error text of error message, if available.

PeerReviewProvidersResponse

Properties
Name Type Description
Providers Array of PeerReviewProvider Peer review providers.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

PendingPaymentsResponse

Properties
Name Type Description
Amount Nullable Decimal-precision floating-point Amount pending to be processed. (∞,∞)
Currency String Currency of pending amount.
Payments Array of PendingPaymentInformation List of pending payments.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

ServiceProvidersResponse

Properties
Name Type Description
Providers Array of ServiceProvider Service providers.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

TransactionResponse

Properties
Name Type Description
Id String Transaction ID
Created Nullable Date & Time Timestamp of creation of transaction (∞,∞)
Processed Nullable Date & Time Timestamp of processing the transaction (∞,∞)
From String Account sending eDaler
FromType Nullable EntityType

Type of entity sending eDaler Possible values:

  • "Operator" - Operator
  • "NetworkJid" - XMPP Address (Bare JID)
  • "LegalId" - Neuro-Foundation Legal ID
To String Account receiving eDaler
ToType Nullable EntityType

Type of entity receiving eDaler Possible values:

  • "Operator" - Operator
  • "NetworkJid" - XMPP Address (Bare JID)
  • "LegalId" - Neuro-Foundation Legal ID
Sender String Sender of request which initiated transaction
Amount Nullable Decimal-precision floating-point Amount of eDaler transferred (∞,∞)
Currency String Currency of amount transferred
Uri URI eDaler URI encoding the request that initiated the transaction.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

PetitionResponse

Properties
Name Type Description
PetitionId String Petition identifier.
QuickResponse Dictionary Requested object available, either in cache or via earlier granted authorization.
Success Boolean Indicates if the operation was successful.
Message String Message associated with the response.

SearchResult

Properties
Name Type Description
More Boolean If more events are available.
NextOffset Nullable 32-bit signed integer Offset into search result set where the next page of events begin, if the More parameter is true. [0,2147483647]
Events Array of Event Array of events returned by the search.

SearchResult

Properties
Name Type Description
NrMatches 32-bit signed integer Number of matches found. [0,∞)
NrFilesTotal 32-bit signed integer Total number of files in account-specific file storage. [0,∞)
Pattern String Search pattern used.
FileNames Array of String File names matching the search pattern.
ResourceUris Array of String Resource URIs matching the search pattern.

PromptMessage

Properties
Name Type Description
Role McpRole

Role of recipient of message. Possible values:

  • "Assistant" - Message is for the assistant.
  • "User" - Message is from the user.
Content Object Content of message.
IsEncoded Boolean If the content has been encoded.
Encoded Dictionary Encoded content.

IdentityProperty

Properties
Name Type Description
Name String
Value String

IdentityAttachment

Properties
Name Type Description
Id String
LegalId String
ContentType String
FileName String
Url String
Signature BASE64-encoded binaryByte[]
Timestamp Date & Time

Byte[]

Properties
Name Type Description
Length 32-bit signed integer
LongLength 64-bit signed integer
Rank 32-bit signed integer
SyncRoot Object
IsReadOnly Boolean
IsFixedSize Boolean
IsSynchronized Boolean

PeerReviewProvider

Properties
Name Type Description
Id String Identifier of the particular service provider.
Type String Type name of service provider.
Name String Displayable name of the service provider.
IconUrl String Icon for the service provider.
IconWidth 32-bit signed integer Width of icon, in pixels.
IconHeight 32-bit signed integer Height of icon, in pixels.
LegalId String Identifier of Legal Identity of which peer reviews can be petitioned.
External Boolean If legal identity is external (true) or belongs to the server (false). Internal providers (false) must be selected before being petitioned.

PendingPaymentInformation

Properties
Name Type Description
Id String ID of payment
Expires Date & Time When payment expires (∞,∞)
Currency String Currency of payment
Amount Decimal-precision floating-point Amount to pay (∞,∞)
From String Sender of eDaler
To String Receiver of eDaler
Uri URI eDaler URI encoding the payment

ServiceProvider

Properties
Name Type Description
Id String Identifier of the particular service provider.
Type String Type name of service provider.
Name String Displayable name of the service provider.
IconUrl String Icon for the service provider.
IconWidth 32-bit signed integer Width of icon, in pixels.
IconHeight 32-bit signed integer Height of icon, in pixels.
ContractTemplateId String Identifier of optional smart contract template that should be used to perform the transaction.

Event

Properties
Name Type Description
ObjectId String ID of event object in persistent storage.
Timestamp Date & Time Timestamp of event, in UTC. (∞,∞)
Type EventType

Type of event. Possible values:

  • "Debug" - Debug event. Debug events highlight technical information to developers, for troubleshooting.
  • "Informational" - Informational event. Informational events provide a record of normal operational tasks being performed or events occurring.
  • "Notice" - Notice event. Notice events highlight important information that may require attention.
  • "Warning" - Warning event. Warning events highlight potential issues that may require attention.
  • "Error" - Error event. Error events indicate a problem that has occurred.
  • "Critical" - Critical event. Critical events indicate errors so great that it could escalate into something graver if not addressed.
  • "Alert" - Alert event. Alert events indicate a condition that requires immediate action.
  • "Emergency" - Emergency event. Emergency events signals the system is unusable, or will become unusable if action is not taken immediately.
Level EventLevel

The level of the event being logged. Minor events occur frequently, Medium events update something, or reports something could cause a major event, Major events adds or destroys something, or reports something important is out of order. Possible values:

  • "Minor" - Minor Event
  • "Medium" - Medium Event
  • "Major" - Major Event
Message String The body text of the logged event.
Object String The object associated with the event, if any.
Actor String The subject, or actor, performing the action resulting in the event being logged.
EventId String Optional Event ID for the event. Event IDs are used to identify a specific type of event, and is used collect related information in reports.
Facility String The subsystem or external component that is the source of the event.
Module String The module or component within the source that is the source of the event.
StackTrace String Stack trace of the event, if any.
Tags Array of Tag Variable set of tags providing event-specific information.

Byte[]

Properties
Name Type Description
Length 32-bit signed integer
LongLength 64-bit signed integer
Rank 32-bit signed integer
SyncRoot Object
IsReadOnly Boolean
IsFixedSize Boolean
IsSynchronized Boolean

Tag

Properties
Name Type Description
Name String Name of tag
Value Object Value of tag