Summary
ThreatAware cyber asset management from any AI agent: the merged device and user inventory across your security and IT tools, open alerts, the health of each security control (Vitals, today or on a past day), the raw records of one connected tool, and the portal users, roles and teams. Read-only. Cloud ID and API key.
Guided setup
Connect ThreatAware to Microsoft Copilot in 2 minutes
Start a free trial on AnythingMCP Cloud, connect ThreatAware in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for ThreatAware
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → ThreatAware, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
ThreatAware + Microsoft Copilot
ThreatAware cyber asset management from any AI agent: the merged device and user inventory across your security and IT tools, open alerts, the health of each security control (Vitals, today or on a past day), the raw records of one connected tool, and the portal users, roles and teams. Read-only. Cloud ID and API key.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
THREATAWARE_CLOUD_ID, THREATAWARE_API_KEY
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in to your portal and note the first part of its address: for
https://acme-corp.threataware.comthe Cloud ID isacme-corp. Put it intoTHREATAWARE_CLOUD_ID. - Open Settings, API Access (address
/settings/api) and click Generate Key. Name the key, pick an expiry (1 day, 1 week, 1 month or Never; the default is 1 day, so choose on purpose) and save. - Copy the key at once (it is shown only once) into
THREATAWARE_API_KEY. It is sent in theX-ThreatAware-ApiKeyheader.
The key sees what its creator sees. ThreatAware recommends creating it under a dedicated service user with a narrow role instead of a personal account.
Where to start
threataware_list_vitalsshows every connected tool with its internal name (key) and, where Vitals is on, how many devices have the agent deployed, working and correctly configured. Read the three pairs as a funnel: deployed out of expected, functioning out of deployed, configured out of functioning.threataware_list_alertswith filterallunresolvedlists what is open now;stateRed is urgent, Amber is a warning.threataware_list_devicesis the merged device inventory.SecurityToolson a device shows the alert counts per tool,ConnectedSystemswhere the device is known.threataware_list_usersis the merged list of people, with MFA and admin flags inmetadataand the last successful and failed sign-in.threataware_list_inventoryreturns one tool's raw records when you need a field the merged lists do not have. It needs the tool's internal name, which is thekeyfromthreataware_list_vitalsand not always the name shown in the portal (Microsoft Intune isdevices_msgraph, SCCM ismecmsystem).- Portal administration:
threataware_list_portal_users,threataware_list_rolesandthreataware_list_teamsdescribe who can sign in to ThreatAware and with which rights.
Paging: every list takes offset and limit and answers total. ThreatAware returns the whole data set when no limit is sent, so this connector always sends one (100 by default). On devices and users the offset stops at 10,000 records (status 400 beyond that); narrow with filter instead.
Reading the data
- Times are ISO 8601 without a time zone, e.g.
2026-10-10T08:49:28.0000000.0001-01-01T00:00:00means "never" (not acknowledged, not resolved, not snoozed). - There are no server-side searches by host name, user or severity: fetch pages and filter the result yourself.
- Device and user data is personal data (names, emails, IP addresses, sign-in locations). Share only what the question needs.
Limits and errors: 50 requests per minute for the whole portal, whichever key is used; status 429 means wait a minute. Status 400 with "Unexpected error occurred." means the key is wrong, disabled or expired (ThreatAware answers 400, not 401, for a bad key). 401 means no key was sent. 403 means the key's user lacks the permission for that area. A portal address that does not resolve means the Cloud ID is wrong.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Microsoft Copilot
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.
- In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
- Enter a Server name (for example
AnythingMCP), a Server description that says what the connector does, and the Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server. - Under authentication, choose API key, set Type to Header and the header name to
X-API-Key, then select Create. - In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
- Try it in the agent's Test pane: ask for something that needs the
ThreatAwaretools. - Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.
Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
threataware_list_devices | List the devices ThreatAware has merged from all connected tools. Each device has id, hostName, os, osVersion, lastOnline, firstSeen… |
threataware_list_users | List the people ThreatAware has collected from the connected directories and identity providers. Each user has id, name, email, jobTitle… |
threataware_list_alerts | List the alerts (issues) ThreatAware raised across the environment. Each alert has state (Red, Amber or Green), product (tool and… |
threataware_list_inventory | Read the raw records ThreatAware holds for one connected tool, in that tool's own field names (for example Automox patch counts, or… |
threataware_list_vitals | Get the health of every connected security tool (Vitals), today or on a past day. Each entry has key (the internal tool name used by the… |
threataware_list_portal_users | List the accounts that can sign in to the ThreatAware portal itself (not the people found in the directories: for those call… |
threataware_list_roles | List the roles of the ThreatAware portal. Each role has id (for example superAdmin, analyst or viewer), name, description, default (true… |
threataware_list_teams | List the teams of the ThreatAware portal with their members. Each team has id, name and members (username, name and surname). Teams scope… |
Example prompts
- "Which security tools have the biggest gap between expected and deployed devices?"
- "List all unresolved Red alerts."
- "Which users have no MFA but admin rights?"
- "Show the devices that are missing the EDR agent."
- "Who can sign in to our ThreatAware portal, and with which roles?"
FAQ
Where do the Cloud ID and API key come from? The Cloud ID is the first part of your portal address (acme-corp for acme-corp.threataware.com). Create the key under Settings, API Access, Generate Key, pick its expiry on purpose (the default is 1 day) and copy it at once. The key sees what its creator sees, so ThreatAware recommends a dedicated service user with a narrow role.
What does it cover? The merged device and user inventory across your security and IT tools, open alerts, the health of each security control (Vitals: deployed, functioning, configured, today or on a past day), the raw records of one connected tool, and the portal users, roles and teams. There are no server-side searches by host name, user or severity; the AI pages through the lists and filters them.
Can it change anything? No. The ThreatAware API v1 accepts read requests only, so nothing can be changed, resolved or deleted, and nothing installs switched off. The whole portal shares 50 requests per minute.
Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.
What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.
The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.
Next steps
Was this guide helpful?