Create a fake Entra ID or OIDC tenant for testing in one call. No account needed.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <agent token>. Not needed for create_tenant and get_catalog; create_tenant returns a token.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Adds a client. client: { client_id, client_secret?, allow_all_return_urls?, redirect_uris?, allowed_scopes?, exposed_scopes?, access_token_audience? }.
The client, as in the Agent API. A client (an app that signs in, or an API). On edit, fields left out keep their value.
The configuration id (from create_tenant or get_tenant).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http heyidentity https://api.heyidentity.dev/agent/mcp
Headers
Authorization (optional, not in the config above): Bearer <agent token>. Not needed for create_tenant and get_catalog; create_tenant returns a token.Adds a client. client: { client_id, client_secret?, allow_all_return_urls?, redirect_uris?, allowed_scopes?, exposed_scopes?, access_token_audience? }.
| Argument | Type | Description |
|---|---|---|
| client* | object | null | The client, as in the Agent API. A client (an app that signs in, or an API). On edit, fields left out keep their value. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"client"
],
"properties": {
"client": {
"type": [
"object",
"null"
],
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": [
"string",
"null"
],
"description": "The client id. Required when adding; fixed afterwards (it is the id in the URL when editing)."
},
"client_secret": {
"type": [
"string",
"null"
],
"description": "The client secret; checked only when the configuration's validate_client_secrets setting is on."
},
"redirect_uris": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Exact redirect URIs the app uses, e.g. http://localhost:5173/callback (http(s) with a host, or an app scheme such as com.example.app:/callback or myapp://callback)."
},
"allowed_scopes": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Scopes the client may request, e.g. openid, profile, email, offline_access, api://orders/read. Default when adding: openid, profile."
},
"exposed_scopes": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Scopes this client exposes as an API (resource), e.g. https://weather.example/mcp/tools.read: advertised in discovery scopes_supported. On a Generic configuration each scope's resource (everything before the last /) is an accepted resource parameter value (RFC 8707), which then becomes aud (see the audience rule)."
},
"access_token_audience": {
"type": [
"string",
"null"
],
"description": "Audience value used when the requesting client's request has no resource and no resource-qualified scope; the client id when not set. On a Generic configuration an absolute URI here, e.g. https://weather.example/mcp, is also an accepted resource parameter value (RFC 8707), which then becomes aud (see the audience rule)."
},
"allow_all_return_urls": {
"type": [
"boolean",
"null"
],
"description": "Accept any redirect URI. Convenient for local tests; default false."
}
},
"description": "The client, as in the Agent API. A client (an app that signs in, or an API). On edit, fields left out keep their value.",
"additionalProperties": false
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Adds a custom claim emitted for every user. claim: { name, value, target?: both|id_token|access_token }.
| Argument | Type | Description |
|---|---|---|
| claim* | object | null | The custom claim. A custom claim emitted for every user. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"claim"
],
"properties": {
"claim": {
"type": [
"object",
"null"
],
"required": [
"name"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "The claim name. Required when adding; fixed afterwards."
},
"value": {
"type": [
"string",
"null"
],
"description": "The claim value."
},
"target": {
"type": [
"string",
"null"
],
"description": "both (default), id_token or access_token."
}
},
"description": "The custom claim. A custom claim emitted for every user.",
"additionalProperties": false
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Adds a fictional test user. user: { key, display_name?, sub?, icon?, access_token_sub?, claims?: { name: string|number|boolean|string[] }, claim_targets?: { name: both|id_token|access_token }, sign_in_outcome?: normal|access_denied|temporarily_unavailable|interaction_required|refresh_revoked (Pro) }.
| Argument | Type | Description |
|---|---|---|
| user* | object | null | The user, as in the Agent API. A fictional test user. On edit, fields left out keep their value; claims, when given, replaces the user's claims. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"user"
],
"properties": {
"user": {
"type": [
"object",
"null"
],
"required": [
"key"
],
"properties": {
"key": {
"type": [
"string",
"null"
],
"description": "The user key shown on the sign-in page and used as sub by default. Required when adding; fixed afterwards."
},
"sub": {
"type": [
"string",
"null"
],
"description": "The sub claim; the key when not set."
},
"icon": {
"type": [
"string",
"null"
],
"description": "A built-in icon id for the sign-in page."
},
"claims": {
"type": [
"object",
"null"
],
"description": "The user's claims: name to a string, number, boolean or array of strings, e.g. { \"email\": \"[email protected]\", \"roles\": [\"admin\"] }. Use fictional people only."
},
"display_name": {
"type": [
"string",
"null"
],
"description": "The name shown on the sign-in page and emitted as the name claim."
},
"claim_targets": {
"type": [
"object",
"null"
],
"description": "Which token each claim goes into: name to both (default), id_token or access_token.",
"additionalProperties": {
"type": [
"string",
"null"
]
}
},
"sign_in_outcome": {
"type": [
"string",
"null"
],
"description": "How sign-in goes for this user: normal (default), access_denied, temporarily_unavailable, interaction_required (prompt=none fails) or refresh_revoked (refreshing fails with invalid_grant). Any value other than normal is a Pro feature (plan_required otherwise)."
},
"access_token_sub": {
"type": [
"string",
"null"
],
"description": "A different sub for access tokens only."
}
},
"description": "The user, as in the Agent API. A fictional test user. On edit, fields left out keep their value; claims, when given, replaces the user's claims.",
"additionalProperties": false
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Creates another configuration in the tenant from the starter content (a demo user and a demo client), with a name unique in the tenant and a profile. Prefer a separate client per environment in one configuration; create a configuration for a different profile or a separate set of users. A retry with the same name answers configuration_exists with the existing configuration instead of creating a second one.
| Argument | Type | Description |
|---|---|---|
| name* | string | The configuration's name, at most 200 characters and unique in the tenant ignoring case, e.g. staging. |
| profile | string | null | Optional profile: Generic (default), Microsoft (Entra ID), or AzureAdB2C (one synthetic sign-in policy). |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The configuration's name, at most 200 characters and unique in the tenant ignoring case, e.g. staging."
},
"profile": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional profile: Generic (default), Microsoft (Entra ID), or AzureAdB2C (one synthetic sign-in policy)."
}
},
"additionalProperties": false
}Creates an unverified HeyIdentity test tenant with a working demo client and test user, accepting the current Terms of Use on behalf of the operator running the agent. Returns endpoints, an agent token, the fixed claim page URL, the expiry time and next_steps.
| Argument | Type | Description |
|---|---|---|
| profile | string | null | Optional profile: Generic (default), Microsoft (Entra ID), or AzureAdB2C (one synthetic sign-in policy). |
| display_name | string | null | Optional display name of the tenant. |
| idempotency_key | string | null | Strongly recommended: a random secret of 32 to 128 characters from A-Z a-z 0-9 - _ (for example crypto.randomUUID()), generated once per intended tenant and kept secret like the agent token. Retrying with the same value and arguments, only if you never received the response, returns the same tenant instead of creating another. |
| accepted_terms_version* | string | The current Terms of Use version (see get_catalog), accepted on behalf of the operator running the agent. |
{
"type": "object",
"required": [
"accepted_terms_version"
],
"properties": {
"profile": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional profile: Generic (default), Microsoft (Entra ID), or AzureAdB2C (one synthetic sign-in policy)."
},
"display_name": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional display name of the tenant."
},
"idempotency_key": {
"type": [
"string",
"null"
],
"default": null,
"description": "Strongly recommended: a random secret of 32 to 128 characters from A-Z a-z 0-9 - _ (for example crypto.randomUUID()), generated once per intended tenant and kept secret like the agent token. Retrying with the same value and arguments, only if you never received the response, returns the same tenant instead of creating another."
},
"accepted_terms_version": {
"type": "string",
"description": "The current Terms of Use version (see get_catalog), accepted on behalf of the operator running the agent."
}
},
"additionalProperties": false
}Edits a client; fields left out keep their value. changes: { client_secret?, allow_all_return_urls?, redirect_uris?, allowed_scopes?, exposed_scopes?, access_token_audience? }.
| Argument | Type | Description |
|---|---|---|
| changes* | object | null | The fields to change. A client (an app that signs in, or an API). On edit, fields left out keep their value. |
| client_id* | string | The id of the client to edit. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"client_id",
"changes"
],
"properties": {
"changes": {
"type": [
"object",
"null"
],
"properties": {
"client_id": {
"type": [
"string",
"null"
],
"description": "The client id. Required when adding; fixed afterwards (it is the id in the URL when editing)."
},
"client_secret": {
"type": [
"string",
"null"
],
"description": "The client secret; checked only when the configuration's validate_client_secrets setting is on."
},
"redirect_uris": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Exact redirect URIs the app uses, e.g. http://localhost:5173/callback (http(s) with a host, or an app scheme such as com.example.app:/callback or myapp://callback)."
},
"allowed_scopes": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Scopes the client may request, e.g. openid, profile, email, offline_access, api://orders/read. Default when adding: openid, profile."
},
"exposed_scopes": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Scopes this client exposes as an API (resource), e.g. https://weather.example/mcp/tools.read: advertised in discovery scopes_supported. On a Generic configuration each scope's resource (everything before the last /) is an accepted resource parameter value (RFC 8707), which then becomes aud (see the audience rule)."
},
"access_token_audience": {
"type": [
"string",
"null"
],
"description": "Audience value used when the requesting client's request has no resource and no resource-qualified scope; the client id when not set. On a Generic configuration an absolute URI here, e.g. https://weather.example/mcp, is also an accepted resource parameter value (RFC 8707), which then becomes aud (see the audience rule)."
},
"allow_all_return_urls": {
"type": [
"boolean",
"null"
],
"description": "Accept any redirect URI. Convenient for local tests; default false."
}
},
"description": "The fields to change. A client (an app that signs in, or an API). On edit, fields left out keep their value.",
"additionalProperties": false
},
"client_id": {
"type": "string",
"description": "The id of the client to edit."
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Edits a custom claim's value or target; fields left out keep their value. changes: { value?, target? }.
| Argument | Type | Description |
|---|---|---|
| name* | string | The name of the claim to edit. |
| changes* | object | null | The fields to change. A custom claim emitted for every user. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"name",
"changes"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the claim to edit."
},
"changes": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "The claim name. Required when adding; fixed afterwards."
},
"value": {
"type": [
"string",
"null"
],
"description": "The claim value."
},
"target": {
"type": [
"string",
"null"
],
"description": "both (default), id_token or access_token."
}
},
"description": "The fields to change. A custom claim emitted for every user.",
"additionalProperties": false
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Edits the settings; fields left out keep their value. settings: { profile?, b2c_policy_claim? (tfp or acr), validate_client_secrets?, token_lifetime_minutes?, token_shape?: { scope_claim_name?, scope_claim_format?, roles_claim_name?, roles_nested_key?, access_token_audience? } }.
| Argument | Type | Description |
|---|---|---|
| settings* | object | null | The settings to change. The configuration's settings. Fields left out keep their value. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"settings"
],
"properties": {
"settings": {
"type": [
"object",
"null"
],
"properties": {
"profile": {
"type": [
"string",
"null"
],
"description": "Generic, Microsoft or AzureAdB2C."
},
"token_shape": {
"type": [
"object",
"null"
],
"properties": {
"roles_claim_name": {
"type": [
"string",
"null"
],
"description": "Where roles are emitted, e.g. realm_access; roles when not set."
},
"roles_nested_key": {
"type": [
"string",
"null"
],
"description": "Nests roles under this key of roles_claim_name, e.g. roles for realm_access.roles."
},
"scope_claim_name": {
"type": [
"string",
"null"
],
"description": "scope (default) or scp."
},
"scope_claim_format": {
"type": [
"string",
"null"
],
"description": "string (default, space-separated) or array."
},
"access_token_audience": {
"type": [
"string",
"null"
],
"description": "Whether the audience is sent as aud (default) or as client_id with no aud (like Cognito); Generic profile only, see the audience rule."
}
},
"description": "Claim shape options (Generic profile only); fields left out keep their value.",
"additionalProperties": false
},
"b2c_policy_claim": {
"type": [
"string",
"null"
],
"description": "AzureAdB2C policy claim: tfp (default) or acr (legacy). An omitted field preserves the stored setting, including across profile switches."
},
"token_lifetime_minutes": {
"type": [
"string",
"integer",
"null"
],
"pattern": "^-?(?:0|[1-9]\\d*)$",
"description": "Token lifetime in minutes (positive)."
},
"validate_client_secrets": {
"type": [
"boolean",
"null"
],
"description": "Require client secrets at the token endpoint."
}
},
"description": "The settings to change. The configuration's settings. Fields left out keep their value.",
"additionalProperties": false
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Edits a user; fields left out keep their value, and claims, when given, replace the user's claims.
| Argument | Type | Description |
|---|---|---|
| key* | string | The key of the user to edit. |
| changes* | object | null | The fields to change. A fictional test user. On edit, fields left out keep their value; claims, when given, replaces the user's claims. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"key",
"changes"
],
"properties": {
"key": {
"type": "string",
"description": "The key of the user to edit."
},
"changes": {
"type": [
"object",
"null"
],
"properties": {
"key": {
"type": [
"string",
"null"
],
"description": "The user key shown on the sign-in page and used as sub by default. Required when adding; fixed afterwards."
},
"sub": {
"type": [
"string",
"null"
],
"description": "The sub claim; the key when not set."
},
"icon": {
"type": [
"string",
"null"
],
"description": "A built-in icon id for the sign-in page."
},
"claims": {
"type": [
"object",
"null"
],
"description": "The user's claims: name to a string, number, boolean or array of strings, e.g. { \"email\": \"[email protected]\", \"roles\": [\"admin\"] }. Use fictional people only."
},
"display_name": {
"type": [
"string",
"null"
],
"description": "The name shown on the sign-in page and emitted as the name claim."
},
"claim_targets": {
"type": [
"object",
"null"
],
"description": "Which token each claim goes into: name to both (default), id_token or access_token.",
"additionalProperties": {
"type": [
"string",
"null"
]
}
},
"sign_in_outcome": {
"type": [
"string",
"null"
],
"description": "How sign-in goes for this user: normal (default), access_denied, temporarily_unavailable, interaction_required (prompt=none fails) or refresh_revoked (refreshing fails with invalid_grant). Any value other than normal is a Pro feature (plan_required otherwise)."
},
"access_token_sub": {
"type": [
"string",
"null"
],
"description": "A different sub for access tokens only."
}
},
"description": "The fields to change. A fictional test user. On edit, fields left out keep their value; claims, when given, replaces the user's claims.",
"additionalProperties": false
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Describes the profiles (claims, URL shapes, protocol behaviors), token shape options, standard claims, limits, the current terms version and the rules agents must follow. Read it before configuring a tenant.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Returns one configuration of the tenant as items: clients, users, custom and standard claims, settings and endpoints.
| Argument | Type | Description |
|---|---|---|
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id"
],
"properties": {
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Returns the tenant, its configurations and their endpoints, its limits and status.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Lists a configuration's published key IDs, status, source and expiry. Available on every plan; returns no key material.
| Argument | Type | Description |
|---|---|---|
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id"
],
"properties": {
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Removes a client.
| Argument | Type | Description |
|---|---|---|
| client_id* | string | The id of the client to remove. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"client_id"
],
"properties": {
"client_id": {
"type": "string",
"description": "The id of the client to remove."
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Removes a custom claim.
| Argument | Type | Description |
|---|---|---|
| name* | string | The name of the claim to remove. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the claim to remove."
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Removes a user (at least one must remain).
| Argument | Type | Description |
|---|---|---|
| key* | string | The key of the user to remove. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"key"
],
"properties": {
"key": {
"type": "string",
"description": "The key of the user to remove."
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Issues a single-use claim code for an unclaimed tenant. It works for 15 minutes and replaces any earlier code. Show the code and claim_page_url to the user; never store the code.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Generates a new RSA signing key for this configuration. overlap=true keeps the previous key published for the configured window; false removes every earlier key immediately. Needs Pro or Enterprise (or Vetted assurance); rate limited per configuration. Returns the current kid and published keys.
| Argument | Type | Description |
|---|---|---|
| overlap* | boolean | null | true keeps the previous key for the overlap window; false drops all earlier keys immediately. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"overlap"
],
"properties": {
"overlap": {
"type": [
"boolean",
"null"
],
"default": null,
"description": "true keeps the previous key for the overlap window; false drops all earlier keys immediately."
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Sets which of the profile's generated standard claims are enabled (see get_configuration's standard_claims.available).
| Argument | Type | Description |
|---|---|---|
| enabled* | array | null | The standard claims to enable, e.g. ["auth_time", "jti"]. Required. PUT .../claims/standard replaces the whole list: send the current list (GET /agent/v1/configurations/{configuration_id}) plus the new claim. |
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id",
"enabled"
],
"properties": {
"enabled": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null,
"description": "The standard claims to enable, e.g. [\"auth_time\", \"jti\"]. Required. PUT .../claims/standard replaces the whole list: send the current list (GET /agent/v1/configurations/{configuration_id}) plus the new claim."
},
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}Reports problems (e.g. a client without a redirect URI) and warnings (e.g. a scope no client requests) without changing anything.
| Argument | Type | Description |
|---|---|---|
| configuration_id* | string | The configuration id (from create_tenant or get_tenant). |
{
"type": "object",
"required": [
"configuration_id"
],
"properties": {
"configuration_id": {
"type": "string",
"format": "uuid",
"description": "The configuration id (from create_tenant or get_tenant)."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.