Setup

Youtrust hosts a remote MCP server at https://developers.youtrust.com/mcp. Simply add it to your AI tool's configuration, including your API key as a Bearer token in the headers field.

{
  "mcpServers": {
    "youtrustAPIDoc": {
      "url": "https://developers.youtrust.com/mcp",
      "headers": {
        "Authorization": "Bearer '${YOUTRUST_API_KEY_SANDBOX}'"
      }
    }
  }
}

{
  "mcpServers": {
    "youtrustAPIDoc": {
      "url": "https://developers.youtrust.com/mcp",
      "headers": {
        "Authorization": "Bearer '${YOUTRUST_API_KEY_SANDBOX}'"
      }
    }
  }
}

claude mcp add --transport http youtrustAPIDoc https://developers.youtrust.com/mcp --header 'Authorization: Bearer ${YOUTRUST_API_KEY_SANDBOX}'

[mcp_servers.youtrustAPIDoc]
url = "https://developers.youtrust.com/mcp"
http_headers = { "Authorization" = "Bearer '${YOUTRUST_API_KEY_SANDBOX}'" }

{
  "servers": {
    "youtrustAPIDoc": {
      "type": "http",
      "url": "https://developers.youtrust.com/mcp",
      "headers": {
        "Authorization": "Bearer '${YOUTRUST_API_KEY_SANDBOX}'"
      }
    }
  }
}

Then, add the Youtrust API Key to your environment variable. For example for Linux & MacOS, in ~/.zshrc or ~/.bashrc files:

export YOUTRUST_API_KEY_SANDBOX="your_sandbox_api_key"

The assistant now has access to your Youtrust documentation and, with a valid API key, to your account through the MCP server.

Testing your setup

Once configured, test the connection:

1. Open your AI tool
2. Start a new chat with the assistant.
3. Ask about the Youtrust API, for example:
   • "Use the YoutrustAPIDoc mcp and list available endpoints."
   • "Use the YoutrustAPIDoc mcp and show me how to create a Signature Request in sandbox."
   • Or more complex one: "Use the YoutrustAPIDoc mcp and build the MVP flow from Signature Request creation to its activation, containing two Signers and a single file (dummy or to be provided by me), in backend's repository language."

Troubleshooting

Missing Security Schemes

Your API key is not reaching the server. Check these three points, in order:

1. The server URL. It must be https://developers.youtrust.com/mcp. Another address redirects, and HTTP clients drop the Authorization header on a cross-domain redirect, so the key never arrives.
2. The Bearer prefix. The header value must be Bearer YOUR_API_KEY, not the key on its own.
3. Restart your AI tool. MCP configuration is read when the client connects, so editing it while the tool is running has no effect.

Unsupported data format

Send an explicit Content-Type: application/json header on write calls (POST, PATCH, PUT). The MCP does not always infer it from the request body.

This value should not be null on a file field

Expected behaviour: the MCP cannot upload binary files. See What the Developer MCP cannot do.

The agent misses part of the documentation

Ask it to run several short, targeted searches instead of one long question. The documentation search matches keywords fairly literally, so a single multi-topic query can silently return an incomplete set.