Skip to main content
Glama
xrpl-identity-mcp

xrpl-identity-mcp

by jarod-vyent

xrpl-identity-mcp

CI npm License: MIT

xrpl-identity-mcp is the first identity-focused MCP server for the XRP Ledger: DIDs (XLS-40), credentials (XLS-70), multisig signer lists, and safe transaction prepare/verify/submit workflows. It prepares unsigned transactions, reads ledger state, verifies signed blobs against intent, and can submit pre-signed blobs without ever taking custody of keys.

Built by Jarod Vyent, from the team behind SciPHR.

Security Model

These invariants are core behavior:

  1. No key custody. The server has no seed, private key, mnemonic, wallet import, or signing path. Signing happens in the user's wallet or agent.

  2. Network is explicit. XRPL_NETWORK is mainnet, testnet, or devnet. The default is testnet. Every tool result includes network.

  3. Mainnet submit is opt-in. tx_submit_signed on mainnet is blocked unless ALLOW_MAINNET_SUBMIT=true is set.

  4. Prepare, verify, then submit. Write workflows return unsigned JSON with instructions to sign externally, call tx_decode_verify, and only then call tx_submit_signed.

Related MCP server: Agent Identity MCP Server

Quickstart

Claude MCP:

claude mcp add xrpl-identity -- npx -y xrpl-identity-mcp

Generic MCP client config:

{
  "mcpServers": {
    "xrpl-identity": {
      "command": "npx",
      "args": ["-y", "xrpl-identity-mcp"],
      "env": {
        "XRPL_NETWORK": "testnet"
      }
    }
  }
}

Environment variables:

Variable

Values

Default

Purpose

XRPL_NETWORK

mainnet, testnet, devnet

testnet

Selects the XRPL network.

XRPL_ENDPOINT

WebSocket URL

Network default

Overrides the rippled WebSocket endpoint.

ALLOW_MAINNET_SUBMIT

true or unset

unset

Required for tx_submit_signed on mainnet.

Default endpoints:

Network

Endpoint

mainnet

wss://xrplcluster.com

testnet

wss://s.altnet.rippletest.net:51233

devnet

wss://s.devnet.rippletest.net:51233

Tools

Tool

What it does

Network writes?

did_resolve

Resolve an XLS-40 DID object and fetch an ipfs:// or https:// DID document when present.

No

did_prepare_set

Prepare an unsigned DIDSet transaction.

No

did_prepare_delete

Prepare an unsigned DIDDelete transaction.

No

credential_prepare_create

Prepare an unsigned CredentialCreate transaction.

No

credential_prepare_accept

Prepare an unsigned CredentialAccept transaction.

No

credential_prepare_delete

Prepare an unsigned CredentialDelete transaction.

No

credential_verify

Read a credential object and report existence, acceptance, and expiration.

No

credential_list

List up to 400 credential objects visible to an account, with issuer/subject filtering.

No

account_identity_summary

Summarize auth posture, signer list, DID presence, and credential counts for an account.

No

signer_list_prepare_set

Prepare an unsigned SignerListSet transaction for multisig create, replace, or delete.

No

tx_decode_verify

Decode a signed blob, compute hash, and compare against expected intent.

No

tx_submit_signed

Submit a pre-signed blob and poll for validation. Mainnet requires ALLOW_MAINNET_SUBMIT=true.

Yes

Example Agent Flows

Resolve a DID and read its document:

  1. Call did_resolve with address set to a classic XRPL address or did:xrpl:<address>.

  2. Inspect decoded.URI, decoded.Data, and decoded.DIDDocument.

  3. If the URI is ipfs:// or https://, inspect document and documentSource. Only text and JSON documents are inlined; binary content (for example an image) is reported as documentSource, documentContentType, and documentByteLength with documentSkipped explaining why the body was omitted.

Issue and accept a credential on testnet:

  1. Set XRPL_NETWORK=testnet.

  2. Call credential_prepare_create with issuer, subject, credential type, optional expiration, and optional URI.

  3. Sign the returned unsignedTx externally with the issuer account.

  4. Call tx_decode_verify with the signed blob and the expected intent.

  5. Call tx_submit_signed.

  6. Call credential_prepare_accept for the subject, sign externally, verify with tx_decode_verify, then submit.

  7. Call credential_verify to confirm accepted: true and expired: false.

Verify a signed blob before submitting:

  1. Call tx_decode_verify with signedBlob and an expectedIntent partial transaction JSON.

  2. Check matches and any mismatches.

  3. Submit only when the decoded transaction matches the user's intent.

Development

npm install
npm run typecheck
npm run build
SKIP_INTEGRATION=1 npm test

Integration tests target testnet and are skipped when SKIP_INTEGRATION=1. To run the account summary integration test, set XRPL_INTEGRATION_ACCOUNT to a funded testnet account address.

License

MIT

Available Tools

12 tools
account_identity_summaryAccount Identity SummaryA

Summarize an XRPL account identity posture: AccountRoot auth flags, RegularKey and Domain state, signer list, DID presence, and visible credential counts as issuer and subject (each with a *Truncated boolean flagging when the count hit the 400-object scan cap).

Inputs: address (required).

credential_listList Account CredentialsA

List up to 400 XLS-70 Credential objects visible in an account owner directory, optionally filtered by whether the account is issuer or subject.

Inputs: address (required), role.

credential_prepare_acceptPrepare CredentialAcceptA

Prepare an unsigned XLS-70 CredentialAccept transaction for a subject to accept an issued credential. Signing happens outside this server.

Inputs: issuer (required), account (required), credentialType (required).

credential_prepare_createPrepare CredentialCreateA

Prepare an unsigned XLS-70 CredentialCreate transaction. The issuer signs externally; this server only prepares JSON and never custodies keys.

Inputs: subject (required), issuerAccount (required), credentialType (required), uri, +1 more.

credential_prepare_deletePrepare CredentialDeleteA

Prepare an unsigned XLS-70 CredentialDelete transaction. The submitter signs externally; this server never signs or stores keys.

Inputs: account (required), credentialType (required), issuer, subject.

credential_verifyVerify CredentialA

Read an XLS-70 Credential ledger object and report whether it exists, has been accepted, and is expired relative to the validated ledger close time.

Inputs: issuer (required), subject (required), credentialType (required).

did_prepare_deletePrepare DIDDeleteA

Prepare an unsigned XLS-40 DIDDelete transaction for an account DID. This server never signs; sign externally and verify the blob before submitting.

Inputs: account (required).

did_prepare_setPrepare DIDSetA

Prepare an unsigned XLS-40 DIDSet transaction. This server does not sign or custody keys; sign externally and verify the signed blob before submission.

Inputs: account (required), uri, data, didDocument.

did_resolveResolve XRPL DIDA

Resolve an XLS-40 DID object for an XRPL account or did:xrpl identifier. Returns raw ledger data, UTF-8 decoded DID fields where valid, and fetched DID document content for ipfs:// or https:// URIs. Only text/JSON documents are inlined; binary content is reported as metadata (source, content type, byte length) with the body omitted.

Inputs: address (required).

signer_list_prepare_setPrepare SignerListSetA

Prepare an unsigned SignerListSet transaction to create, replace, or delete an XRPL multisign signer list. This server never signs or stores keys.

Inputs: quorum (required), account (required), signers (required).

tx_decode_verifyDecode and Verify Signed TransactionA

Decode a signed XRPL transaction blob, compute its hash, and optionally compare it against an expected partial intent before submission. This is the WYSIWYS safety gate.

Inputs: signedBlob (required), expectedIntent.

tx_submit_signedSubmit Signed TransactionA

Submit a pre-signed XRPL transaction blob and poll for validation. On mainnet this is blocked unless ALLOW_MAINNET_SUBMIT=true is set.

Inputs: signedBlob (required), failHard.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct operation: account summary, credential CRUD, DID management, signer list preparation, and transaction verification/submission. No two tools have overlapping purposes.

    Naming Consistency5/5

    All tools use snake_case with a consistent verb_noun pattern (e.g., credential_prepare_create, did_resolve). The naming is uniform and predictable.

    Tool Count5/5

    12 tools are well-scoped for the XRPL identity domain, covering credentials, DIDs, signer lists, and transaction safety without being excessive.

    Completeness4/5

    The tool set covers the main identity operations (credential lifecycle, DID, signer list) and includes transaction safety tools. Missing are account root flag modification and regular key management, but these are minor gaps for the focused purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for AI agent identity — verify agents with Ed25519 signatures, check trust scores, sign and verify content, exchange encrypted messages. Built on the Agent Identity Protocol (AIP).
      8
      1
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Mock identity-management MCP server for decentralized identity that allows minting DIDs, issuing signed Verifiable Credentials, and verifying them.
      8
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides a sovereign, MIT-licensed MCP server for professional-service workflows, running entirely on your infrastructure with Ed25519 cryptographic signing for every action.
      MIT