MCPAPIWebhooks100+ tools

Security your own AI tools can operate.

Convoy's MCP server is scoped to your tenant and works with any MCP client. The assistants your team already uses can list leads, run queries, write rules and contain hosts, under the same permissions and the same audit trail as the console.

Your tenant

Any MCP client

Access   OAuth sign-in or an API key
Scope    your tenant, nothing else
Record   every call in your audit trail

Live session

{{ t.n }}
{{typed}}

Getting started

Three steps. The second one takes a minute.

  1. 1

    Sign in or make a key

    Connect with OAuth as yourself, or make an API key in the console. Either way it carries your role and nothing more.

  2. 2

    Add the server to your client

    Add your tenant's address to any MCP client, then sign in or paste the key. No SDK, no plugin.

  3. 3

    Ask your own assistant for what you need

    Triage the overnight leads, explain a noisy rule, draft a case summary, pull every sign-in for one account across every source.

Tool reference

Pick a task. See which tools fire.

100+ tools is a list. This is what they're for. Every call runs under the connected user's role. Your AI tool sees the full set the moment it connects.

Leads · 4 calls

Triage the overnight leads

What came in since 18:00, what matters, and why the rest can close.

01
List leads

Everything new since 18:00, newest first, with severity and state.

read
02
Open a lead

Open the one that matters: narrative, entities, confidence score.

read
03
Lead timeline

Who did what to it and when, including the triage determinations.

read
04
Update a lead

Close the rest as non-concern, each with a written reason.

write

Respond · 4 calls

Contain a host

Isolate rdweb01, open the case, tell the owner.

01
List response actions

What containment this tenant can perform, and the fields each one needs.

read
02
Run a response action

Isolate rdweb01 through Convoy Agent. One step reverses it.

contain
03
Open a case

Open a case from the lead with the evidence attached.

write
04
Incident thread

Find the incident thread so the right people hear it first.

read

Guard · 4 calls

Write and test a rule

A new detection for scheduled tasks created by service accounts.

01
Describe a source

What fields the Sysmon and Windows security logs actually carry.

read
02
Create a rule

Draft the rule, mapped to T1053.005, scoped to svc-* accounts.

write
03
Test a rule

Dry-run it against 30 days of your own events before it goes anywhere.

read
04
Send for review

Send it up the review ladder. Nothing goes live on its own.

write

Query · 4 calls

Sweep for an indicator

Has anything talked to the IP from this morning's advisory?

01
Run a query

Queries firewall, proxy and Convoy Agent telemetry for the last 30 days.

read
02
Read the results

The rows, paginated, ready to drop into a case.

read
03
Save a query

Keep it as a shared query the whole team can re-run.

write
04
Create a rule

Turn the sweep into a standing rule so the next match is a lead.

write

Email · 4 calls

Pull a phishing email

Fourteen mailboxes got it. Two clicked.

01
List signals

Which mailboxes received the message and who opened the link.

read
02
Run a response action

Delete it from every inbox in one action.

contain
03
Update a lead

Close the lead as contained, with the mailbox list in the reason.

write
04
Add a case note

Note the two users who clicked and the reset that went out.

write

Insights · 4 calls

Brief the board

Numbers a board can read, straight from your data.

01
Read posture

Score, tier, ATT&CK coverage and the trend.

read
02
Fleet overview

Assets protected, agent coverage, the ten riskiest.

read
03
List cases

Cases closed this quarter, by severity and time to contain.

read
04
Audit trail

Every action taken in the quarter, by person or by playbook.

read

readwritecontainA read-only role stops at the first ring. Containment needs a role that can contain in the console, too.

Permissions

A tool can never do more than the person who connected it.

Checked on every call

Permissions are re-checked on every tool call. Reads need read, writes need write.

Same roles as the console

Connections follow the role ladder your team already has. Nothing new to govern.

Errors it can explain

When a role doesn't clear a tool, you get a machine-readable reason, not a silent failure.

Threads stay private

Incident threads keep their parties-only rule. Your AI tool only reads or posts where the connected user is a party.

API

Prefer plain HTTP? There's an API for that.

Everything your AI tool can reach is there too, with OAuth or an API key and the same permissions. The reference lives in your console.

Webhooks

Let any system fire an Autopilot playbook.

Webhook-triggered automations carry their own secret, so a ticketing system, a form or a script can start a playbook without holding an API key. Every firing is a recorded run.

  • Its own secret, so no API key changes hands
  • Only armed webhook automations fire
  • Each run audited like any other

Your SOC, inside whatever your engineers already have open.

Connect your own assistant to your tenant and ask it something you'd normally ask us.

Start free · 14 daysBook a briefing