Skip to content

MCP Tool Catalog

Remote MCP endpoint, auth model, and tool arguments for Certyn MCP.

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
  • environmentKey: environment key for assistant context
  • conversationId: continue an existing assistant conversation
  • currentPage, selectedTestCaseId, selectedTicketId: optional chat context fields for ask_certyn

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.

ask_certyn

Arguments:

{
  "message": "What is failing most often in staging?",
  "projectIdOrSlug": "acme-web",
  "environmentKey": "staging",
  "conversationId": "optional-existing-conversation-id",
  "currentPage": "/app/acme-web/staging/dashboard",
  "selectedTestCaseId": "optional-test-case-id",
  "selectedTicketId": "optional-ticket-id"
}

Returns the standard Certyn chat response shape:

{
  "conversationId": "conversation-id",
  "messageId": "assistant-message-id",
  "content": "assistant response",
  "role": "assistant",
  "toolCalls": [],
  "createdAt": "2026-03-31T00:00:00Z"
}

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.
  • ask_certyn is non-streaming in v1.
  • list_conversations limits are clamped server-side.