Remote MCP server for 4chems hosted IUCLID, CHESAR and QSAR Toolbox: onboarding, inquiries, admin.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Accept a pending invitation and grant the invitee's first role assignment. Call this when an invitee has a valid invite link and wants to join the tenant; single-use, consuming the token marks it accepted.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Accept a pending invitation and grant the invitee's first role assignment. Call this when an invitee has a valid invite link and wants to join the tenant; single-use, consuming the token marks it accepted.
| Argument | Type | Description |
|---|---|---|
| token* | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization",
"token"
],
"properties": {
"token": {
"type": "string"
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Request a new service subscription for the caller's tenant and return its status. Call this when a tenant admin wants to add a service (ADR 0016 code fix: requires `admin`, was `customer` realm role only).
| Argument | Type | Description |
|---|---|---|
| body | object | |
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"service"
],
"properties": {
"service": {
"type": "string"
}
}
},
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Approve a pending access request: issue a `member` invitation to the requester and resolve the request (level `admin` or `owner` of the request's tenant). The response carries the single-use invitation token to hand to the requester, who accepts via `accept_invitation`. 409 `access_request.not_pending` unless the request is pending.
| Argument | Type | Description |
|---|---|---|
| authorization* | string | |
| access_request_id* | string |
{
"type": "object",
"required": [
"authorization",
"access_request_id"
],
"properties": {
"authorization": {
"type": "string"
},
"access_request_id": {
"type": "string"
}
},
"additionalProperties": false
}Complete the tenant's billing details: legal-entity name and type, VAT id, invoice address, invoice email and optional PO reference. Call this when the owner or a billing contact has the details. EU VAT ids are validated against VIES by the worker; a failed operation with `billing.vat_check_unavailable` can be retried by submitting again. Returns `202` with an operation to poll.
| Argument | Type | Description |
|---|---|---|
| body | object | `complete_billing` body. `vat_id` is checked against the tenant's country in the service. |
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"address_line1",
"postal_code",
"city",
"invoice_email"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
]
},
"vat_id": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"other_label": {
"anyOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 2
},
{
"type": "null"
}
]
},
"postal_code": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"po_reference": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
]
},
"address_line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address_line2": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"invoice_email": {
"type": "string",
"format": "email"
},
"legal_entity_type": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2,3}_[A-Z0-9][A-Z0-9_]*$"
},
{
"type": "null"
}
]
}
},
"description": "`complete_billing` body. `vat_id` is checked against the tenant's country in the service."
},
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Request access to the tenant that owns the caller's verified email domain.
| Argument | Type | Description |
|---|---|---|
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Invite an email address to the caller's tenant at the specified access level and return the invitation, including the raw single-use accept token. Call this when a tenant admin wants to add a new member; the invitee accepts via `accept_invitation`.
| Argument | Type | Description |
|---|---|---|
| body | object | |
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email"
},
"level": {
"enum": [
"viewer",
"member",
"admin",
"owner"
],
"type": "string",
"description": "The grantable tenant access levels (ADR 0016 decision 3: role collapse).\n\nScoped department/instance roles (``team_admin``, ``env_admin``,\n``app_admin``, ``application_owner``, ``application_supervisor``,\n``application_user``) and the platform roles (``platform_admin``,\n``node_admin``) are no longer grantable; the migration\n(``uc087accesslevelscore_0001``) maps every existing row onto one of\nthese four values."
},
"billing_contact": {
"type": "boolean",
"default": false
}
}
},
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Create a 7-day trial tenant for the caller's business email domain (UC-052). Needs a verified email on a business domain and `attestation: true`; answers `auth.email_not_verified`, `tenant.attestation_required`, `tenant.free_mail_domain` (free-mail address), `tenant.domain_exists` (a live trial tenant on the domain) or `trial.exists_for_domain` (the domain already had its one trial; call `start_inquiry`). The trial lasts exactly 7 days; `ttl` / `expires_at` in the body are ignored.
| Argument | Type | Description |
|---|---|---|
| body | object | Request body for POST /v1/onboarding/tenants (UC-052). The domain is derived from the caller's verified token email claim (NFR-006 pt 4) — it is not a request parameter. attestation must be true; the endpoint raises 422 if false (NFR-006 §8a). |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"legal_entity",
"attestation"
],
"properties": {
"attestation": {
"type": "boolean"
},
"bot_signals": {
"anyOf": [
{
"type": "object",
"properties": {
"honeypot": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"submit_timing_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"description": "Advisory bot-detection signals from the onboarding wizard (UC-052).\n\nRecorded and fed to scoring; never used as a hard gate."
},
{
"type": "null"
}
]
},
"legal_entity": {
"type": "object",
"required": [
"country",
"legal_entity_type",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"other_label": {
"anyOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 2
},
{
"type": "null"
}
]
},
"legal_entity_type": {
"type": "string",
"pattern": "^[A-Z]{2,3}_[A-Z0-9][A-Z0-9_]*$"
}
},
"description": "Composite legal-entity input validated against the country catalog.\n\nRules:\n- *country* must be a supported market (validated at field level via SupportedCountry,\n caught in the model validator against the loaded catalog).\n- *legal_entity_type* must appear in that country's catalog file.\n- When *legal_entity_type* is ``<CC>_OTHER``, *other_label* is required (2-80 chars).\n- For any other type, *other_label* must be absent."
}
},
"description": "Request body for POST /v1/onboarding/tenants (UC-052).\n\nThe domain is derived from the caller's verified token email claim\n(NFR-006 pt 4) — it is not a request parameter.\nattestation must be true; the endpoint raises 422 if false (NFR-006 §8a)."
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Dismiss a pending access request (level `admin` or `owner` of the request's tenant). The requester is mailed — naming the tenant, never the dismissing admin — and may ask again. 409 `access_request.not_pending` unless the request is pending.
| Argument | Type | Description |
|---|---|---|
| authorization* | string | |
| access_request_id* | string |
{
"type": "object",
"required": [
"authorization",
"access_request_id"
],
"properties": {
"authorization": {
"type": "string"
},
"access_request_id": {
"type": "string"
}
},
"additionalProperties": false
}Fetch the caller's domain imprint and suggest legal-entity details (UC-057).
| Argument | Type | Description |
|---|---|---|
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Return the tenant's stored billing details: VAT id, invoice address, invoice email and PO reference. Call this to check whether billing is complete; only the owner and billing contacts may read it (`403 rbac.insufficient_level`).
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Return the enabled ApplicationTemplate catalog, ordered by name. Call this to discuss trial and template options with a prospect or customer before starting a trial. If this doesn't answer your question, call `start_inquiry` to ask 4chems directly or request a call.
| Argument | Type | Description |
|---|---|---|
| authorization | string |
{
"type": "object",
"properties": {
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Return the legal-entity types available for *country*, ordered alphabetically. If this doesn't answer your question, call `start_inquiry` to ask 4chems directly or request a call.
| Argument | Type | Description |
|---|---|---|
| country* | string | ISO 3166-1 alpha-2 country code |
| authorization | string |
{
"type": "object",
"required": [
"country"
],
"properties": {
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Return the caller's access level per related tenant. Call this to check what the current caller is authorized to do before attempting an action that requires a specific level, or to discover a pending invitation or access request.
| Argument | Type | Description |
|---|---|---|
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Return the status, result and error of an operation the caller started, such as the `Location` of a `202` from `complete_billing`. Call this to poll it to completion.
| Argument | Type | Description |
|---|---|---|
| operation_id* | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization",
"operation_id"
],
"properties": {
"operation_id": {
"type": "string"
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Return the next onboarding step. If this doesn't answer your question, call `start_inquiry` to ask 4chems directly or request a call.
| Argument | Type | Description |
|---|---|---|
| authorization | string |
{
"type": "object",
"properties": {
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Grant a role x scope assignment to a tenant member.
| Argument | Type | Description |
|---|---|---|
| sub* | string | |
| body | object | |
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization",
"sub"
],
"properties": {
"sub": {
"type": "string"
},
"body": {
"type": "object",
"default": "",
"required": [
"role",
"scope_type",
"scope_id"
],
"properties": {
"role": {
"type": "string"
},
"scope_id": {
"type": "string"
},
"scope_type": {
"type": "string"
}
}
},
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Return the caller's own recorded consents plus the tenant-scope consents of every tenant where the caller is at least a viewer. Call this to check which legal documents have already been accepted before asking again. Pass `tenant_id` to list one tenant's consents only (a caller of several tenants must).
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}List all invitations for the caller's tenant, most recent first. Call this to show a tenant admin which invitations are pending, accepted, or revoked; the raw token is never included.
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}List tenant members with their effective role x scope assignments.
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Return the caller's tenant's active service subscriptions. Call this before offering to add a service, to check what is already subscribed.
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Record acceptance of a legal document version and return the entry; call this only after showing the user the document URL and version and receiving an explicit affirmative answer.
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string | |
| document_code* | string | |
| document_version* | string |
{
"type": "object",
"required": [
"authorization",
"document_code",
"document_version"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
},
"document_code": {
"type": "string"
},
"document_version": {
"type": "string"
}
},
"additionalProperties": false
}Revoke a role x scope assignment from a tenant member.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| sub* | string | |
| tenant_id | string | |
| authorization* | string |
{
"type": "object",
"required": [
"authorization",
"sub",
"id"
],
"properties": {
"id": {
"type": "string"
},
"sub": {
"type": "string"
},
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
}
},
"additionalProperties": false
}Revoke a pending invitation so its token can no longer be accepted. Call this when a tenant admin wants to withdraw an invite sent by mistake or no longer needed; accepted invitations cannot be revoked.
| Argument | Type | Description |
|---|---|---|
| tenant_id | string | |
| authorization* | string | |
| invitation_id* | string |
{
"type": "object",
"required": [
"authorization",
"invitation_id"
],
"properties": {
"tenant_id": {
"type": "string",
"default": ""
},
"authorization": {
"type": "string"
},
"invitation_id": {
"type": "string"
}
},
"additionalProperties": false
}Start registering a 4chems account with a business email address (`email`, `name`, optional `company`). Anonymous. Emails a 6-digit code to the address; no account exists yet. Ask the user for the code, then call verify_account_registration with the returned challenge_id and code. Free-mail addresses (gmail.com, ...) are refused: use the company address, or call start_inquiry. The answer is the same whether or not the address already has an account.
| Argument | Type | Description |
|---|---|---|
| body | object | Request body for POST /v1/onboarding/registrations/account (UC-088). |
| authorization | string |
{
"type": "object",
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"email",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"email": {
"type": "string"
},
"company": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
}
},
"description": "Request body for POST /v1/onboarding/registrations/account (UC-088)."
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Sign in to an existing account by device login (UC-091, RFC 8628). Anonymous, empty body; the account must exist (start_account_registration, then set the password through the emailed link). Show `verification_uri` (or `verification_uri_complete`) and `user_code` to the human, who signs in there, then call `verify_device_login` with `challenge_id`, waiting `interval` seconds between calls. The response never contains the Keycloak device_code or the agent client secret.
| Argument | Type | Description |
|---|---|---|
| authorization | string |
{
"type": "object",
"properties": {
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Store an anonymous inquiry draft and email a 6-digit verification code. Ask the user for the code, then call verify_inquiry with the returned challenge_id and code — the inquiry reaches 4chems only after that verification succeeds.
| Argument | Type | Description |
|---|---|---|
| body | object | |
| authorization | string |
{
"type": "object",
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"name",
"email",
"topic",
"message"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"email": {
"type": "string",
"format": "email"
},
"topic": {
"enum": [
"migration",
"hosting",
"iuclid",
"chesar",
"qsar_toolbox",
"other"
],
"type": "string"
},
"company": {
"type": "string",
"default": "",
"maxLength": 120
},
"message": {
"type": "string",
"maxLength": 4000,
"minLength": 10
},
"website": {
"type": "string",
"default": ""
}
}
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}DEPRECATED: use start_device_login. Deprecated — use start_device_login (same behaviour).
| Argument | Type | Description |
|---|---|---|
| authorization | string |
{
"type": "object",
"properties": {
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Verify the emailed 6-digit code (`challenge_id`, `code`) and create the 4chems account. Never guess or retry codes, and never ask the user for a password.
| Argument | Type | Description |
|---|---|---|
| body | object | Request body for POST /v1/onboarding/registrations/account/verify (UC-089). |
| authorization | string |
{
"type": "object",
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"challenge_id",
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"challenge_id": {
"type": "string",
"format": "uuid"
}
},
"description": "Request body for POST /v1/onboarding/registrations/account/verify (UC-089)."
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Poll a device login to token issuance (UC-091, RFC 8628). Anonymous. While the human has not signed in yet it answers `{"status": "pending", "retry_after": <seconds>}`: wait `retry_after` seconds and call again with the same `challenge_id`. On approval it returns Keycloak's token set (`access_token`, `refresh_token`, `expires_in`, ...) exactly once; pass the `access_token` as `authorization` ('Bearer <token>') to every other tool.
| Argument | Type | Description |
|---|---|---|
| body | object | Request body for POST /v1/onboarding/registrations/device/verify (UC-075). |
| authorization | string |
{
"type": "object",
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"challenge_id"
],
"properties": {
"challenge_id": {
"type": "string",
"format": "uuid"
}
},
"description": "Request body for POST /v1/onboarding/registrations/device/verify (UC-075)."
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Verify the 6-digit code and deliver the inquiry to the helpdesk inbox.
| Argument | Type | Description |
|---|---|---|
| body | object | |
| authorization | string |
{
"type": "object",
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"challenge_id",
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 6,
"minLength": 6
},
"challenge_id": {
"type": "string",
"format": "uuid"
}
}
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}DEPRECATED: use verify_device_login. Deprecated — use verify_device_login (same behaviour).
| Argument | Type | Description |
|---|---|---|
| body | object | Request body for POST /v1/onboarding/registrations/device/verify (UC-075). |
| authorization | string |
{
"type": "object",
"properties": {
"body": {
"type": "object",
"default": "",
"required": [
"challenge_id"
],
"properties": {
"challenge_id": {
"type": "string",
"format": "uuid"
}
},
"description": "Request body for POST /v1/onboarding/registrations/device/verify (UC-075)."
},
"authorization": {
"type": "string",
"default": ""
}
},
"additionalProperties": false
}Withdraw the caller's own pending access request; no notification is sent. Any other caller gets 404 `access_request.not_found`, the same as for an unknown id. 409 `access_request.not_pending` unless pending.
| Argument | Type | Description |
|---|---|---|
| authorization* | string | |
| access_request_id* | string |
{
"type": "object",
"required": [
"authorization",
"access_request_id"
],
"properties": {
"authorization": {
"type": "string"
},
"access_request_id": {
"type": "string"
}
},
"additionalProperties": false
}