The Keldyn MCP server is served over Streamable HTTP and authenticates with OAuth 2.1. There is no API key or static token — signing in through your browser is the only way to connect.
Data security
Encryption, access, and how MCP access differs from your coding agent’s own access.
Cybersecurity
The security frameworks we align with and how the service is tested for vulnerabilities.
Compliance
Model training, data location, subprocessors, GDPR/DPA, attestations.
Responsible use
What KC is for, what it isn’t for, and where human judgement stays in charge.
Data flow
Where your data goes, step by step, from tool call to answer.
Find your MCP URL
The Keldyn MCP server answers every request at the root path (/):
Prerequisites
Before connecting, confirm the following:- Keldyn account — You sign in with your normal Keldyn credentials in the browser during the OAuth flow.
- Team membership — You must belong to at least one team. You’ll pick a team during sign-in, and every request is scoped to it.
- Team admin (for some tools) — Listing integration-collected control evidence (
list-control-evidence) and all Trust Center management tools (*-trust-center-*) require a team-admin (or owner) token. - Supported AI tool — Any client that supports remote MCP servers with OAuth, including Claude Code, Cursor, VS Code, and Codex.
Claude Code
1
Add the MCP server
Run the following command in your terminal:
2
Authenticate
In Claude Code, run
/mcp and select keldyn. A webpage will open in your browser — sign in, choose the team you want to act as, and click Allow.3
Start using Keldyn MCP
Once authorized, you’re ready to start querying and updating your Keldyn data from Claude Code.
Add to Cursor
1
Open Cursor settings
Open Settings in Cursor.
2
Add a custom MCP server
Select Tools & MCP → Add custom MCP.
3
Add the Keldyn configuration
Paste the following configuration:
4
Authenticate
Cursor opens the Keldyn consent page in your browser. Sign in, choose a team, and approve. Cursor completes the OAuth handshake automatically.
Other MCP-compatible clients
Keldyn MCP is a standard remote MCP server over Streamable HTTP. Any tool that can connect to a remote MCP endpoint with OAuth — including VS Code (via an MCP-capable extension), Codex, and other emerging MCP clients — can connect to Keldyn. The setup steps above (Claude Code, Cursor) are the officially tested paths. Other clients aren’t formally validated, but typically work with the same two pieces of configuration:- Server URL —
https://mcp.keldyn.ai/. See Find your MCP URL. - Authentication — OAuth. Sign in as a Keldyn user and pick a team when the browser flow opens.
/.well-known/oauth-protected-resource metadata and opens the consent page for you.
How authentication works
Keldyn MCP is an OAuth 2.1 Resource Server, so you never paste a token or key. When your client first connects, it walks the standard discovery-and-consent flow for you:1
Discovery
Your client makes an unauthenticated request, receives a
401 with a WWW-Authenticate challenge, and reads the server’s Protected Resource Metadata to discover Keldyn’s Authorization Server.2
Registration & consent
Your client registers itself (Dynamic Client Registration) and opens the Keldyn consent page (PKCE,
S256). You sign in, select a team, and approve.3
Token exchange
Your client exchanges the authorization code for a short-lived access token (about 1 hour) plus a refresh token, and calls the MCP endpoint with
Authorization: Bearer <token>.What your AI agents can do with Keldyn MCP
Once connected, your AI assistant can work across your GRC program. Tools call the Keldyn API on your behalf; org context is resolved automatically from the team you signed in with.Frameworks & use cases
list-frameworks— Browse compliance/security frameworks (scope to a use case, the org, or all frameworks).list-use-cases— List use cases for your team, with pagination and filters (search, status, risk level, business area, owner).get-use-case— Fetch a single use case, including its frameworks and details.update-use-case-architecture— Create or update a use case’s Threagile architecture model.analyze-use-case-architecture— Run or fetch Threagile security analysis plus RCM architecture compliance checks for a use case, returning a unified, severity-sorted, paginated list of fixable issues.update-risk-tracking— Record a disposition (mitigated,accepted,false-positive,in-progress,in-discussion) for a single Threagile security risk, with who/why.
Controls, tracking & evidence
list-controls— List RCM controls across use-case and org scopes, each with implementation status and a human-readable status label.get-control— Fetch a single control byrcmIdwith all API fields plus its tracking entry (status, evidence text, assignee, finding, timestamps).update-control— Update a control’s implementation tracking (todo,in_progress,complete,ignored) and optionally set evidence text, assignee, or a finding.list-control-links— List audits, measures, obligations, or documents linked to a control.list-control-evidence— List integration-collected (automated) control evidence with freshness/status. (Requires a team-admin token.)list-evidences/get-evidence— Browse and fetch manual measure evidence (files and links).
Audits
list-audits/get-audit— List audits for the organization and fetch a single audit.list-audit-controls— List the controls in scope for an audit.
GRC entities
list-entities/get-entity— Access risks, measures, obligations, findings, tasks, and data records.list-entity-links— Traverse links between entities (e.g. risks → measures, obligations → controls).
Knowledgebase
These tools search the team’s Knowledgebase index (Library uploads, use case documents, and connected Drive, Confluence, Notion, and Otter sources). They require the Read organisational context permission and a Keldyn-admin session — the same gates as the web app.search-knowledge— Hybrid search over the index. Returns cited passages, not a drafted answer.answer-knowledge— Same retrieval with neighbouring context and grounding instructions so your agent drafts a cited answer itself.list-knowledge-tree/fetch-knowledge-document/fetch-document-section/fetch-knowledge-source— Browse the index as folders, open a file by path, read one section at a time, or inspect a connector’s sync status.create-knowledge-document— Write a manual entry the same way New file does in the index browser.
search-org-context prompt lists the team’s real sources up front so an agent can tell “not documented” from “connector never synced”, and instructs it not to answer from general knowledge.
Tasks
list-tasks/get-task— List and fetch organization tasks, filtered by measure, state, priority, or search.create-task/update-task/delete-task— Full task CRUD; link a task to the control it addresses withrcmId.
Trust Center
Manage your organization’s public Trust Center — the customer-facing compliance portal. These tools require a team-admin token, and the organization is resolved from your team automatically.get-trust-center-status/update-trust-center-status— Check whether the public Trust Center is enabled (with its slug and public URL) and turn it on or off.get-trust-center-profile/update-trust-center-profile— Read and update branding and contact settings (summary, primary color, contact email, privacy policy link, controls-updated badge). Image assets are uploaded from the web app.list-trust-center-frameworks/update-trust-center-frameworks— List assigned frameworks with their publish settings and publish/unpublish badges, includingplanned/achievedstatus and target quarter/year.list-trust-center-controls/set-trust-center-control-sharing— List your controls grouped by framework with their public sharing state, and show or hide an individual control on the public page.list-trust-center-resources/update-trust-center-resource/delete-trust-center-resource— Manage the published document library (title, description, framework tag, label, published state, and public vs. access-gated visibility). New file uploads are done from the web app.list-trust-center-domains— List configured custom domains and their verification status (read-only; domains are added and verified in the web app).list-trust-center-access-requests/grant-trust-center-access-request/deny-trust-center-access-request— Review visitor requests for gated resources and approve or decline them. Approving emails the requester a 45-day access link; declining notifies them.list-trust-center-access-grants/deactivate-trust-center-access-grant— List issued access links and revoke one immediately.get-public-trust-center— Preview the full public payload (branding, published frameworks, shared controls, resources, subprocessors) for a slug, domain, or organization.
Built-in workflows (prompts)
The Keldyn MCP server ships guided prompts that combine your controls with your local repository context, so your agent can act with the right compliance framing:review-changes— Review your code changes against the org’s Keldyn controls.review-codebase— Review the whole codebase (or a scoped path/package) against controls.start-dev— Prime the agent with developer guidance from applicable controls.generate-architecture— Infer a Threagile architecture from your codebase and save it to a use case.collect-evidence— Scan your codebase for positive evidence that code-related controls are satisfied, then confirm before saving.remediate-insufficient-evidence— Find controls whose evidence failed acceptance criteria and gather stronger file-backed proof.search-org-context— Search Knowledgebase with the team’s real sources listed up front, and refuse to answer from general knowledge.
Resources
Model Context Protocol
Learn more about the open protocol that powers the Keldyn MCP server and other AI tool integrations.
MCP Inspector
Interactively test and debug an MCP server — list and call the Keldyn tools, prompts, and resources against a running instance.