Certyn provides a remote MCP server for assistant-first workflows over Streamable HTTP.

Endpoint

https://api.certyn.io/api/mcp

Manifest:

https://certyn.io/server.json

Auth model

Transport: streamable-http
Authentication: user bearer token via Auth0/OIDC
Unsupported in v1: API keys, demo tokens, prompts, resources

Common arguments

Several tools accept shared selectors:

projectIdOrSlug: project ID or slug resolved by Certyn server-side
testCaseId: Certyn test case ID for detail and update operations
ticketId: Certyn ticket ID, external issue ID, or project ticket number
expectedLastEditedAt: optional wiki optimistic-lock timestamp from get_project_wiki.lastEditedAt

`list_projects`

Lists projects visible to the current tenant user.

Returns the same overview payload used by the Certyn app, including project IDs, slugs, default environment hints, onboarding status, and counts.

`list_environments`

Arguments:

{
  "projectIdOrSlug": "optional-project-slug"
}

Returns tenant-visible environments across all projects or only the resolved project.

`get_project_wiki`

Arguments:

{
  "projectIdOrSlug": "acme-web"
}

Returns wiki and memory sections: overview, business logic, rules, common memory, Explorer memory, and last-edit metadata.

`update_wiki`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "overviewMarkdown": "Complete replacement markdown",
  "businessLogicMarkdown": "Optional complete replacement markdown",
  "rulesMarkdown": "Optional complete replacement markdown",
  "commonMemoryMarkdown": "Optional complete replacement markdown",
  "explorerMemoryMarkdown": "Optional complete replacement markdown",
  "expectedLastEditedAt": "2026-03-31T00:00:00Z"
}

Replaces only the sections supplied. Omitted sections are left unchanged.

`list_test_cases`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "tag": "smoke",
  "isQuarantined": false,
  "page": 1,
  "pageSize": 50
}

Returns a paged list of native Certyn test cases.

`get_test_case`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "testCaseId": "test-case-id"
}

Returns full test case detail.

`list_tickets`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "type": "bug",
  "severity": "major",
  "status": "in_review",
  "agentId": "optional-agent-template-id",
  "environmentKey": "staging",
  "environmentVersion": "2026.03.31",
  "page": 1,
  "pageSize": 50
}

Returns a paged list of native Certyn tickets/issues. Filters are optional.

`get_ticket`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "ticketId": "ticket-id-or-number"
}

Returns full ticket detail, including status, severity, attachments, linked test case, latest run state, and external tracker metadata.

`create_test_case`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "name": "Checkout accepts valid cart",
  "instructions": "1. Add an item.\n2. Place the order.\nExpected: confirmation appears.",
  "description": "Smoke coverage for checkout.",
  "tags": ["checkout", "smoke"],
  "coverageKey": "checkout:valid-cart"
}

Creates one native Certyn test case.

`create_test_cases_batch`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "testCases": [
    {
      "name": "Checkout accepts valid cart",
      "instructions": "1. Add an item.\n2. Place the order.\nExpected: confirmation appears.",
      "description": "Smoke coverage for checkout.",
      "tags": ["checkout", "smoke"],
      "coverageKey": "checkout:valid-cart"
    }
  ]
}

Creates up to 50 native Certyn test cases in one call.

`update_test_case`

Arguments:

{
  "projectIdOrSlug": "acme-web",
  "testCaseId": "test-case-id",
  "name": "Updated title",
  "description": "Updated description",
  "instructions": "Updated steps",
  "tags": ["regression"],
  "needsReview": true,
  "isQuarantined": false,
  "isObsolete": false,
  "reviewReason": "Updated after checkout change",
  "supersededByTestCaseId": "replacement-test-case-id",
  "coverageKey": "checkout:valid-cart"
}

Updates only the fields supplied.

`list_conversations`

Arguments:

{
  "projectIdOrSlug": "optional-project-slug",
  "limit": 20
}

Returns recent tenant-owned conversations, optionally filtered to a single project.

`get_conversation`

Arguments:

{
  "conversationId": "conversation-id"
}

Returns full message history for the specified tenant-owned conversation.

Behavior notes

All tool access is filtered to the current tenant and user permissions.
Project resolution accepts either a project ID or slug.
Write tools are exposed with MCP write annotations so clients can ask for confirmation before mutating project records.
list_conversations limits are clamped server-side.

MCP Tool Catalog