{ "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-10-08", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.4", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run" }, "tool": { "slug": "microsoft-teams", "name": "Microsoft Teams (Microsoft Graph)", "vendor": "Microsoft", "vendorUrl": "https://learn.microsoft.com/en-us/graph/teams-concept-overview", "kind": "http-api", "category": "productivity", "summary": "Microsoft Graph endpoints for Microsoft Teams. An app lists teams, channels and chats, reads and sends messages, manages members and receives change notifications over REST, with OAuth tokens from Microsoft Entra ID for work or school accounts.", "url": "https://www.anchorterminal.com/tools/microsoft-teams", "markdownUrl": "https://www.anchorterminal.com/tools/microsoft-teams.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/microsoft-teams.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/microsoft-teams.json", "repo": "https://github.com/microsoftgraph/msgraph-sdk-javascript", "license": "MIT (SDKs)", "transports": [ "http" ], "remoteUrl": "https://graph.microsoft.com/v1.0", "packages": [ { "registry": "npm", "name": "@microsoft/microsoft-graph-client" }, { "registry": "pypi", "name": "msgraph-sdk" } ], "auth": "oauth", "authNotes": "OAuth 2.0 tokens from Microsoft Entra ID, after a person registers an app. Work or school accounts only. Every Teams reference page we read marks personal Microsoft accounts as not supported. Delegated permissions such as `Chat.Read`, `ChatMessage.Send` and `ChannelMessage.Send` need only the user's consent, while delegated `ChannelMessage.Read.All` and all tenant-wide application permissions need admin consent. Application permissions can send messages only for migration. Resource-specific consent lets a team or chat owner grant an installed app access to that one team or chat.", "pricing": "byo-plan", "pricingNotes": "Teams calls aren't charged. Microsoft stopped metering the Teams APIs on 25 August 2025 and no billing setup is needed (https://learn.microsoft.com/en-us/graph/metered-api-list). The tenant needs Microsoft 365 or Teams licences, and Microsoft's plan price page answered our request with a block page on 8 October 2026, so licence prices are unread. No free route for personal accounts was found. The Microsoft 365 developer programme sandbox, with Teams and 25 user licences, is free only to members who qualify. The Teams MCP server needs a Microsoft 365 Copilot licence.", "priceSummary": "Your plan", "where": "hosted", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the Teams reference or the metered API list (checked 2026-10-08).", "endpoints": [] }, "toolCount": 25, "popularity": { "githubStars": 835, "npmWeekly": 2882852, "pypiWeekly": 1578201, "asOf": "2026-10-08" }, "docsUrl": "https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview", "openapi": "https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml", "capabilities": [ "work.chat" ], "tags": [ "hosted", "official", "oauth", "openapi", "webhooks", "typescript", "python", "enterprise" ], "lastRelease": "2026-10-06", "graded": true, "anchor": { "graded": true, "score": 62.2, "grade": "B", "agentReady": false, "rank": 345, "ranked": true, "rankOf": 722, "categoryRank": 1, "methodology": "0.4", "run": "2026-10-01", "scores": { "ergonomics": 59, "maintenance": 76, "payments": 20, "reliability": 67, "schema": 92, "security": 71, "transparency": 76 }, "pending": [ "performance", "tasks" ], "breakdown": [ { "key": "reliability", "name": "Reliability", "weight": 16, "effectiveWeight": 20, "score": 67, "points": 13.4, "reason": "Graded on the v1.0 REST API. A public Microsoft service health page at status.cloud.microsoft (20). It renders only with JavaScript, so we couldn't read components or history (5). Teams limits are published for each endpoint per app, per app per tenant, per resource and per user, for example 1 send a second per chat and per user (15). 429 responses carry `Retry-After`, with backoff guidance and SDK retry handlers, but sending a message has no idempotency key, so a retried send can post twice (10 of 15). The Online Services SLA of October 2026 gives Microsoft Teams credits below 99.9 per cent uptime, measured on users' messaging and meetings and not naming the Graph API (7 of 10). Team, channel, chat and message endpoints are generally available on v1.0 (10)." }, { "key": "performance", "name": "Performance", "weight": 10, "effectiveWeight": 0, "pending": true, "points": 0, "reason": "Pending. Latency is measured per call by our probes, which haven't run yet, so this run doesn't score it. Its weight is shared across the assessed categories until the first probe window closes." }, { "key": "schema", "name": "Schema \u0026 documentation", "weight": 13, "effectiveWeight": 16.25, "score": 92, "points": 14.95, "reason": "OpenAPI for all of Graph v1.0 in microsoftgraph/msgraph-metadata (25). learn.microsoft.com/llms.txt returned 404, but every reference page we asked for with `Accept: text/markdown` came back as Markdown (10). Reference pages state the purpose of each call, list permissions from least to most privileged and say which query parameters are unsupported, and the send page warns against using Teams as a log (17). Typed properties and enumerations such as `importance` and `messageType`, though the message body is free-form HTML or text (12). Request and response examples in several languages on each page and a shared error format, with few Teams-specific error codes listed (13). v1.0 and beta, a dated changelog and a monthly What's new page updated on 8 October 2026 (15)." }, { "key": "ergonomics", "name": "Agent ergonomics", "weight": 13, "effectiveWeight": 16.25, "score": 59, "points": 9.59, "reason": "Message lists can't be trimmed. List channel messages takes only `$top` and `$expand`, with no `$select`, and bodies come back as HTML when a message has a mention (12 of 25). `@odata.nextLink` paging at up to 50 messages a page, a date filter on chat messages, delta queries and change notifications, but no text search on message lists, and the Microsoft Search API covers only the signed-in user's messages (14 of 20). Errors carry a code, message and request ID (15 of 20). Messages have an `etag`, but sending has no idempotency key, and the preview Teams MCP reference calls posting not idempotent and lists no readOnlyHint or destructiveHint annotations (5 of 20). Only `body` is required to send, and official SDKs cover C#, Go, Java, Python and JavaScript, though the JavaScript client on npm is 3.0.7 from September 2023 (13 of 15)." }, { "key": "security", "name": "Security \u0026 auth", "weight": 14, "effectiveWeight": 17.5, "score": 71, "points": 12.43, "reason": "OAuth 2.0 through Microsoft Entra ID with delegated and application permissions, split into `Chat.ReadBasic`, `Chat.Read`, `Chat.ReadWrite`, `ChatMessage.Send` and `ChannelMessage.Send` (30). Sending is separate from reading, application tokens can't send outside migration, and resource-specific consent limits an app to one team or chat. Nothing asks for confirmation before a send or delete (17 of 20). Message bodies written by other members reach the caller, and no injection guidance was found in the Teams reference or the Teams MCP reference (0). Graph activity logs record requests per app, but need Entra ID P1 or P2 and an Azure log destination (12 of 15). microsoft.com's security.txt names the MSRC report portal, a bounty policy and a disclosure policy but passed its Expires date on 23 September 2026, the Office 365 SOC 2 Type 2 report lists Microsoft Teams, and a token-leak fix in the JavaScript client sits unreleased with no advisory (12 of 20)." }, { "key": "payments", "name": "Payments \u0026 pricing", "weight": 10, "effectiveWeight": 12.5, "score": 20, "points": 2.5, "reason": "No x402, MPP or L402 (0). Teams APIs have not been metered since 25 August 2025, so calls carry no charge, but the tenant needs Microsoft 365 or Teams licences and the plan price page answered us with a block page (15 of 20). Personal Microsoft accounts aren't supported, and the free developer programme sandbox is open only to members who qualify (5 of 20). A person registers an app in Entra and signs in, and an admin consents for tenant-wide permissions (0)." }, { "key": "tasks", "name": "Task success", "weight": 10, "effectiveWeight": 0, "pending": true, "points": 0, "reason": "Pending. Task success needs the category task suites run through each tool, which haven't run yet, so this run doesn't score it. Its weight is shared across the assessed categories until then. A data provider's data-quality score is published on its listing now and becomes half of this category when it's scored." }, { "key": "maintenance", "name": "Maintenance \u0026 community", "weight": 7, "effectiveWeight": 8.75, "score": 76, "points": 6.65, "reason": "msgraph-sdk-python v1.64.0 on 6 October 2026 (30). Eight Python SDK tags since 10 July 2026, from v1.59.0 to v1.64.0 (20). A public changelog, a What's new page updated on 8 October 2026 with a Teams messaging entry for September 2026, and SDK issue trackers, but a security fix merged into the JavaScript client on 16 June 2026 still hasn't reached npm, and the changelog feed's newest entry is 3 August 2026 (10 of 15). Current SDKs in most languages, with the JavaScript client the exception at 3.0.7 (10 of 15). Active tagging on the Python repository, none of it reaching the JavaScript package (6 of 10)." }, { "key": "transparency", "name": "Transparency \u0026 trust", "weight": 7, "effectiveWeight": 8.75, "score": 76, "points": 6.65, "note": "editorial 67, provenance 85", "reason": "Closed service under the Microsoft APIs terms of use, last updated October 2025, with MIT SDKs (15). Microsoft 365's retention page says deleted customer content is removed within 30 days and within 180 days of a subscription ending, the Teams residency page says chats and channel messages are stored in an Azure chat service with a copy in user and group mailboxes, and the privacy statement is dated September 2026. We didn't read the data protection addendum (22 of 30). A written policy of at least 24 months' notice before a v1.0 API or version is retired (20). Storage locations for Teams data are published, but we didn't read a sub-processor list (10 of 20)." } ], "assessment": { "date": "2026-10-08", "basis": "public evidence", "confidence": "medium", "notes": { "ergonomics": "Message lists can't be trimmed. List channel messages takes only `$top` and `$expand`, with no `$select`, and bodies come back as HTML when a message has a mention (12 of 25). `@odata.nextLink` paging at up to 50 messages a page, a date filter on chat messages, delta queries and change notifications, but no text search on message lists, and the Microsoft Search API covers only the signed-in user's messages (14 of 20). Errors carry a code, message and request ID (15 of 20). Messages have an `etag`, but sending has no idempotency key, and the preview Teams MCP reference calls posting not idempotent and lists no readOnlyHint or destructiveHint annotations (5 of 20). Only `body` is required to send, and official SDKs cover C#, Go, Java, Python and JavaScript, though the JavaScript client on npm is 3.0.7 from September 2023 (13 of 15).", "maintenance": "msgraph-sdk-python v1.64.0 on 6 October 2026 (30). Eight Python SDK tags since 10 July 2026, from v1.59.0 to v1.64.0 (20). A public changelog, a What's new page updated on 8 October 2026 with a Teams messaging entry for September 2026, and SDK issue trackers, but a security fix merged into the JavaScript client on 16 June 2026 still hasn't reached npm, and the changelog feed's newest entry is 3 August 2026 (10 of 15). Current SDKs in most languages, with the JavaScript client the exception at 3.0.7 (10 of 15). Active tagging on the Python repository, none of it reaching the JavaScript package (6 of 10).", "payments": "No x402, MPP or L402 (0). Teams APIs have not been metered since 25 August 2025, so calls carry no charge, but the tenant needs Microsoft 365 or Teams licences and the plan price page answered us with a block page (15 of 20). Personal Microsoft accounts aren't supported, and the free developer programme sandbox is open only to members who qualify (5 of 20). A person registers an app in Entra and signs in, and an admin consents for tenant-wide permissions (0).", "reliability": "Graded on the v1.0 REST API. A public Microsoft service health page at status.cloud.microsoft (20). It renders only with JavaScript, so we couldn't read components or history (5). Teams limits are published for each endpoint per app, per app per tenant, per resource and per user, for example 1 send a second per chat and per user (15). 429 responses carry `Retry-After`, with backoff guidance and SDK retry handlers, but sending a message has no idempotency key, so a retried send can post twice (10 of 15). The Online Services SLA of October 2026 gives Microsoft Teams credits below 99.9 per cent uptime, measured on users' messaging and meetings and not naming the Graph API (7 of 10). Team, channel, chat and message endpoints are generally available on v1.0 (10).", "schema": "OpenAPI for all of Graph v1.0 in microsoftgraph/msgraph-metadata (25). learn.microsoft.com/llms.txt returned 404, but every reference page we asked for with `Accept: text/markdown` came back as Markdown (10). Reference pages state the purpose of each call, list permissions from least to most privileged and say which query parameters are unsupported, and the send page warns against using Teams as a log (17). Typed properties and enumerations such as `importance` and `messageType`, though the message body is free-form HTML or text (12). Request and response examples in several languages on each page and a shared error format, with few Teams-specific error codes listed (13). v1.0 and beta, a dated changelog and a monthly What's new page updated on 8 October 2026 (15).", "security": "OAuth 2.0 through Microsoft Entra ID with delegated and application permissions, split into `Chat.ReadBasic`, `Chat.Read`, `Chat.ReadWrite`, `ChatMessage.Send` and `ChannelMessage.Send` (30). Sending is separate from reading, application tokens can't send outside migration, and resource-specific consent limits an app to one team or chat. Nothing asks for confirmation before a send or delete (17 of 20). Message bodies written by other members reach the caller, and no injection guidance was found in the Teams reference or the Teams MCP reference (0). Graph activity logs record requests per app, but need Entra ID P1 or P2 and an Azure log destination (12 of 15). microsoft.com's security.txt names the MSRC report portal, a bounty policy and a disclosure policy but passed its Expires date on 23 September 2026, the Office 365 SOC 2 Type 2 report lists Microsoft Teams, and a token-leak fix in the JavaScript client sits unreleased with no advisory (12 of 20).", "transparency": "Closed service under the Microsoft APIs terms of use, last updated October 2025, with MIT SDKs (15). Microsoft 365's retention page says deleted customer content is removed within 30 days and within 180 days of a subscription ending, the Teams residency page says chats and channel messages are stored in an Azure chat service with a copy in user and group mailboxes, and the privacy statement is dated September 2026. We didn't read the data protection addendum (22 of 30). A written policy of at least 24 months' notice before a v1.0 API or version is retired (20). Storage locations for Teams data are published, but we didn't read a sub-processor list (10 of 20)." }, "sources": [ { "what": "Teams overview in Microsoft Graph", "url": "https://learn.microsoft.com/en-us/graph/teams-concept-overview", "seen": "2026-10-08" }, { "what": "Teams API overview, limits and polling rule", "url": "https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "throttling limits for Microsoft Teams", "url": "https://learn.microsoft.com/en-us/graph/throttling-limits", "seen": "2026-10-08" }, { "what": "throttling guidance and Retry-After", "url": "https://learn.microsoft.com/en-us/graph/throttling", "seen": "2026-10-08" }, { "what": "send chatMessage reference and permissions", "url": "https://learn.microsoft.com/en-us/graph/api/chatmessage-post?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "send message in a chat reference", "url": "https://learn.microsoft.com/en-us/graph/api/chat-post-messages?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "list channel messages reference", "url": "https://learn.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "list chat messages reference", "url": "https://learn.microsoft.com/en-us/graph/api/chat-list-messages?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "chatMessage resource", "url": "https://learn.microsoft.com/en-us/graph/api/resources/chatmessage?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "chat message delta reference", "url": "https://learn.microsoft.com/en-us/graph/api/chatmessage-delta?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "channel getAllMessages reference", "url": "https://learn.microsoft.com/en-us/graph/api/channel-getallmessages?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "change notifications for Teams messages", "url": "https://learn.microsoft.com/en-us/graph/teams-changenotifications-chatmessage", "seen": "2026-10-08" }, { "what": "subscription lifetimes", "url": "https://learn.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0", "seen": "2026-10-08" }, { "what": "Microsoft Search API for Teams messages", "url": "https://learn.microsoft.com/en-us/graph/search-concept-chat-messages", "seen": "2026-10-08" }, { "what": "permissions reference, Chat and ChannelMessage permissions", "url": "https://learn.microsoft.com/en-us/graph/permissions-reference", "seen": "2026-10-08" }, { "what": "resource-specific consent", "url": "https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/rsc/resource-specific-consent", "seen": "2026-10-08" }, { "what": "national cloud differences for Teams APIs", "url": "https://learn.microsoft.com/en-us/graph/teamwork-national-cloud-differences", "seen": "2026-10-08" }, { "what": "metered API list, Teams no longer metered", "url": "https://learn.microsoft.com/en-us/graph/metered-api-list", "seen": "2026-10-08" }, { "what": "Graph activity logs", "url": "https://learn.microsoft.com/en-us/graph/microsoft-graph-activity-logs-overview", "seen": "2026-10-08" }, { "what": "error responses", "url": "https://learn.microsoft.com/en-us/graph/errors", "seen": "2026-10-08" }, { "what": "versioning, support and breaking change policy", "url": "https://learn.microsoft.com/en-us/graph/versioning-and-support", "seen": "2026-10-08" }, { "what": "What's new in Microsoft Graph", "url": "https://learn.microsoft.com/en-us/graph/whats-new-overview", "seen": "2026-10-08" }, { "what": "Graph changelog feed", "url": "https://developer.microsoft.com/en-us/graph/changelog/rss", "seen": "2026-10-08" }, { "what": "limits and specifications for Microsoft Teams", "url": "https://learn.microsoft.com/en-us/microsoftteams/limits-specifications-teams", "seen": "2026-10-08" }, { "what": "Teams MCP reference (preview)", "url": "https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-teams-tools", "seen": "2026-10-08" }, { "what": "Work IQ MCP overview and licence", "url": "https://learn.microsoft.com/en-us/microsoft-agent-365/tooling-servers-overview", "seen": "2026-10-08" }, { "what": "Microsoft MCP Server for Enterprise overview", "url": "https://learn.microsoft.com/en-us/graph/mcp-server/overview", "seen": "2026-10-08" }, { "what": "Microsoft APIs terms of use", "url": "https://learn.microsoft.com/en-us/legal/microsoft-apis/terms-of-use", "seen": "2026-10-08" }, { "what": "Microsoft privacy statement", "url": "https://privacy.microsoft.com/en-us/privacystatement", "seen": "2026-10-08" }, { "what": "Online Services SLA, October 2026 edition", "url": "https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services", "seen": "2026-10-08" }, { "what": "Microsoft 365 data retention and deletion", "url": "https://learn.microsoft.com/en-us/compliance/assurance/assurance-data-retention-deletion-and-destruction-overview", "seen": "2026-10-08" }, { "what": "data residency for Microsoft Teams", "url": "https://learn.microsoft.com/en-us/microsoft-365/enterprise/m365-dr-workload-teams", "seen": "2026-10-08" }, { "what": "SOC 2 Type 2 for Office 365", "url": "https://learn.microsoft.com/en-us/compliance/regulatory/offering-soc-2", "seen": "2026-10-08" }, { "what": "Microsoft 365 developer programme FAQ", "url": "https://learn.microsoft.com/en-us/office/developer-program/microsoft-365-developer-program-faq", "seen": "2026-10-08" }, { "what": "security.txt (Expires 2026-09-23)", "url": "https://www.microsoft.com/.well-known/security.txt", "seen": "2026-10-08" }, { "what": "service health page (JavaScript only)", "url": "https://status.cloud.microsoft/", "seen": "2026-10-08" }, { "what": "Teams plan prices (block page)", "url": "https://www.microsoft.com/en-us/microsoft-teams/compare-microsoft-teams-business-options", "seen": "2026-10-08" }, { "what": "OpenAPI and CSDL metadata", "url": "https://github.com/microsoftgraph/msgraph-metadata", "seen": "2026-10-08" }, { "what": "JavaScript client repository, token-leak fix and advisory list", "url": "https://github.com/microsoftgraph/msgraph-sdk-javascript", "seen": "2026-10-08" }, { "what": "npm latest for @microsoft/microsoft-graph-client", "url": "https://registry.npmjs.org/@microsoft/microsoft-graph-client/latest", "seen": "2026-10-08" }, { "what": "Python SDK tags", "url": "https://github.com/microsoftgraph/msgraph-sdk-python", "seen": "2026-10-08" }, { "what": "PyPI msgraph-sdk", "url": "https://pypi.org/pypi/msgraph-sdk/json", "seen": "2026-10-08" }, { "what": "RDAP record for microsoft.com", "url": "https://rdap.verisign.com/com/v1/domain/microsoft.com", "seen": "2026-10-08" } ], "openQuestions": [ "unchecked: status page components and incident history, which need JavaScript", "unchecked: Microsoft 365 and Teams plan prices, because www.microsoft.com answered our request with a block page", "unchecked: the MSRC bounty pages, the data protection addendum and the Microsoft 365 sub-processor list, which we didn't read", "unchecked: the protected APIs page for Teams (the address we tried returned 404), so we didn't establish whether tenant-wide message reading still needs a request to Microsoft beyond admin consent", "Whether the Teams SLA's uptime measure would be applied to an outage of the Graph endpoints alone. The document doesn't name the API", "Whether Microsoft will publish msgraph-sdk-javascript 3.0.8 or an advisory for the 16 June 2026 fix", "The Work IQ overview links a Work IQ Teams reference, and that address served the same preview Teams reference with 25 tools. We didn't establish whether a separate Work IQ Teams tool list exists", "The changelog feed's newest entry is 3 August 2026 while the What's new page was updated on 8 October 2026. We didn't establish why the feed stops there", "lastRelease is the Python SDK release of 6 October 2026. The newest generally available Teams messaging entry on What's new is dated only September 2026", "The lead was right on the vendor, interface and docs link. It didn't say that personal accounts are unsupported or that application permissions can't send messages" ] }, "negative": -4, "negativeNotes": [ "2026-06-16: a fix for a token leak through URL userinfo host confusion was merged into msgraph-sdk-javascript and the version bumped to 3.0.8, but on 8 October 2026 npm still serves 3.0.7 from September 2023 and the repository's advisory list is empty. Exploiting it needs an attacker-influenced URL passed to the client (https://github.com/microsoftgraph/msgraph-sdk-javascript/commit/5438ae90f50ef15d3656f0cf9c5485deee351f19, https://registry.npmjs.org/@microsoft/microsoft-graph-client/latest)" ], "verdict": "Permissions separate sending from reading, and resource-specific consent limits an app to one team or chat. Throttling limits are published per endpoint. Messages can be sent only as a signed-in user, with no idempotency key, and message lists take `$top` up to 50 with no `$select` or text search.", "bestFor": "Agents acting as a signed-in employee in a Microsoft 365 tenant that read channels and chats and post replies.", "strengths": [ "Separate delegated permissions for sending (`ChatMessage.Send`, `ChannelMessage.Send`) and reading (`Chat.Read`, `ChannelMessage.Read.All`), plus `Chat.ReadBasic` for names and members only", "Resource-specific consent grants an app access to a single team or chat instead of the whole tenant", "Throttling limits published for each endpoint across four dimensions, with `Retry-After` on 429 responses", "Teams APIs stopped being metered on 25 August 2025, so calls carry no charge and need no billing setup", "Change notifications on channel and chat messages can carry the message itself, and Microsoft states at least 24 months' notice before removing a v1.0 API" ], "weaknesses": [ "Application permissions can send messages only for migration (`Teamwork.Migrate.All`), so an unattended agent can't post without a signed-in user", "Sending has no idempotency key, and Microsoft's own Teams MCP reference calls posting not idempotent and warns against blind retries", "Channel message lists accept only `$top` (default 20, maximum 50) and `$expand`, with no `$select`, `$filter` or `$search`", "Personal Microsoft accounts aren't supported, and the free developer sandbox is limited to programme members who qualify", "No prompt-injection guidance found in the Teams reference or the Teams MCP reference, though message bodies are written by other people", "The npm JavaScript client is 3.0.7 from September 2023, without the June 2026 token-leak fix" ], "agentNotes": [ "Send with delegated `ChatMessage.Send` or `ChannelMessage.Send` as a signed-in work account. Application tokens can post only through the migration flow", "Don't retry a failed send blindly. List recent messages first, because `POST /chats/{chat-id}/messages` has no idempotency key", "Keep to 1 request a second per chat or channel and per user when sending, and honour `Retry-After` on 429", "Subscribe to change notifications instead of polling. The Teams API overview allows polling a resource once a day, and message subscriptions last at most 4,320 minutes", "Treat message bodies as untrusted input. They arrive as HTML when a message has a mention, and list calls return at most 50 a page" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "B", "methodology": "0.4", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 62.2 } ], "editorialScores": { "ergonomics": 59, "maintenance": 76, "payments": 20, "reliability": 67, "schema": 92, "security": 71, "transparency": 67 }, "provenanceScore": 85 }, "connect": { "http": "curl \"https://graph.microsoft.com/v1.0/me/joinedTeams\" \\\n -H \"Authorization: Bearer $MS_GRAPH_TOKEN\"" }, "letme": { "capability": "https://letme.dev/work.chat", "tool": "https://letme.dev/microsoft-teams" }, "sameCompany": [ "azure-foundry-fine-tuning", "azure-ai-content-safety", "azure-speech-to-text", "azure-text-to-speech", "microsoft-agent-framework", "microsoft-execution-containers", "microsoft-entra-agent-id", "azure-key-vault", "azure-devops-mcp", "microsoft-learn-mcp", "playwright-mcp", "azure-mcp", "azure-maps", "azure-translator", "microsoft-graph-calendar", "dynamics-365-sales", "power-automate", "microsoft-advertising-api", "microsoft-excel-graph", "outlook-mail-graph" ], "notable": [ "Teams throttling is counted per app, per app per tenant, per resource and per user. Sending a chat message is limited to 200 requests a second per app, 20 per app per tenant, 1 per chat and 1 per user, and a sustained limit of about 83 per cent of each figure also applies (https://learn.microsoft.com/en-us/graph/throttling-limits#microsoft-teams-service-limits)", "Sending a message with application permissions is supported only for migration, through `Teamwork.Migrate.All`. Normal sends need delegated `ChatMessage.Send` or `ChannelMessage.Send` (https://learn.microsoft.com/en-us/graph/api/chatmessage-post)", "The send reference says using Teams as a log file breaks the terms of use and that apps should only send messages people will read (https://learn.microsoft.com/en-us/graph/api/chatmessage-post)", "List channel messages accepts only `$top` (default 20, maximum 50) and `$expand` for replies, and list chat messages accepts `$top` up to 50 with a date filter (https://learn.microsoft.com/en-us/graph/api/channel-list-messages, https://learn.microsoft.com/en-us/graph/api/chat-list-messages)", "The Teams API overview allows polling a resource once a day and tells apps to use change notifications for anything more frequent (https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview)", "Change notification subscriptions on chat messages last at most 4,320 minutes, and one that expires more than an hour ahead must name a `lifecycleNotificationUrl` (https://learn.microsoft.com/en-us/graph/api/resources/subscription, https://learn.microsoft.com/en-us/graph/teams-changenotifications-chatmessage)", "Delta queries over a user's chat messages return only the last eight months (https://learn.microsoft.com/en-us/graph/api/chatmessage-delta)", "The Online Services SLA of October 2026 gives Microsoft Teams service credits of 25 per cent below 99.9 per cent uptime, measured as users unable to hold instant messaging conversations or start meetings. It doesn't name the Graph API (https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services)", "The Teams MCP server (`mcp_TeamsServer`) lists 25 tools, is in preview, and Microsoft says it shouldn't be used in production or new projects (https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-teams-tools)" ], "area": "business", "details": [ { "label": "Graded surface", "value": "The v1.0 REST API at https://graph.microsoft.com/v1.0 for teams, channels, chats and messages. Calls, meetings, Shifts and the preview Teams MCP server weren't graded" }, { "label": "Free tier", "value": "No charge for Teams calls. The tenant needs Microsoft 365 or Teams licences. Personal Microsoft accounts aren't supported" }, { "label": "Accounts", "value": "Work or school accounts in a Microsoft Entra tenant. Available in the global service and the US Government and China national clouds, with some differences" }, { "label": "Permissions", "value": "`Chat.ReadBasic`, `Chat.Read`, `Chat.ReadWrite`, `ChatMessage.Send`, `ChannelMessage.Send`, `ChannelMessage.Read.All`, `Team.ReadBasic.All` and `Channel.ReadBasic.All`, plus resource-specific permissions such as `ChannelMessage.Read.Group` and `ChatMessage.Read.Chat`" }, { "label": "Sending", "value": "Delegated only. Application permissions send only through the migration flow. `POST` returns 201 Created with the message, and only `body` is required" }, { "label": "Rate limits", "value": "Per endpoint. Send a chat message 200 a second per app, 20 per app per tenant, 1 per chat and 1 per user. List channel messages 200 per app, 20 per app per tenant and 1 per channel" }, { "label": "Paging", "value": "`$top` up to 50 on message lists, default 20 for channel messages, with `@odata.nextLink`. Replies come 200 at a time through `$expand`" }, { "label": "Search", "value": "No `$search` on message lists. The Microsoft Search API searches Teams messages for the signed-in user only and can't sort results" }, { "label": "Sync", "value": "Delta query over a user's chat messages for the last eight months, and change notifications by webhook" }, { "label": "Change notifications", "value": "Message subscriptions last up to 4,320 minutes and can include the message, encrypted. Tenant-wide subscriptions need application permissions" }, { "label": "Message size", "value": "About 100 KB a post, per the Teams limits page" }, { "label": "SLA", "value": "Microsoft Teams, 99.9 per cent uptime with service credits, in the Online Services SLA of October 2026. The Graph API isn't named" }, { "label": "SDKs", "value": "C#, Go, Java, JavaScript and others shown on reference pages. Python `msgraph-sdk` 1.64.0 (6 October 2026) and npm `@microsoft/microsoft-graph-client` 3.0.7 (September 2023)" }, { "label": "MCP server", "value": "Teams (`mcp_TeamsServer`), 25 tools, preview, per-tenant endpoint on agent365.svc.cloud.microsoft, Microsoft 365 Copilot licence" }, { "label": "Deprecation", "value": "At least 24 months' notice before a v1.0 API or version is retired" } ], "provenance": { "legalEntity": "Microsoft Corporation", "domain": "microsoft.com", "domainRegistered": "1991-05-02", "domainNote": "The endpoint is on graph.microsoft.com. microsoft.com publishes a security.txt, but it passed its Expires date on 2026-09-23.", "endpointOnVendorDomain": true, "terms": "https://learn.microsoft.com/en-us/legal/microsoft-apis/terms-of-use", "privacy": "https://privacy.microsoft.com/en-us/privacystatement", "statusPage": "https://status.cloud.microsoft", "changelog": "https://developer.microsoft.com/en-us/graph/changelog", "securityTxt": "expired", "checked": "2026-10-08", "notes": [ "The Microsoft service health page at status.cloud.microsoft needs JavaScript to show anything.", "The Microsoft APIs terms of use say they were last updated in October 2025 and name Microsoft Teams among the Office 365 APIs they cover.", "The Microsoft privacy statement says it was last updated in September 2026.", "RDAP for microsoft.com gives a registration date of 1991-05-02." ], "score": 85, "checks": [ { "check": "Legal entity named", "value": "Microsoft Corporation", "points": 20, "max": 20, "state": "ok" }, { "check": "Domain age", "value": "microsoft.com, registered 1991-05-02 (35 years)", "points": 15, "max": 15, "state": "ok" }, { "check": "Endpoint on the vendor's domain", "value": "graph.microsoft.com", "points": 15, "max": 15, "state": "ok" }, { "check": "Terms of service", "value": "read, states 5 of the 7 things a reader expects, and has 3 clauses that cost points", "points": 2.3, "max": 10, "state": "part" }, { "check": "Privacy policy", "value": "read, states 8 of the 8 things a reader expects, and has 1 clause that costs points", "points": 8, "max": 10, "state": "part" }, { "check": "Status page", "value": "status.cloud.microsoft", "points": 10, "max": 10, "state": "ok" }, { "check": "Changelog", "value": "published", "points": 10, "max": 10, "state": "ok" }, { "check": "security.txt", "value": "published but past its Expires date", "points": 5, "max": 10, "state": "part" } ], "policies": [ { "kind": "terms", "url": "https://learn.microsoft.com/en-us/legal/microsoft-apis/terms-of-use", "state": "read", "readAt": "2026-10-08", "statedDate": "2025-10-01", "words": 4555, "points": 2.3, "max": 10, "expected": [ { "key": "terms.date", "label": "Gives the date it was last updated", "found": true, "quote": "Last Updated: October 2025 What's new?", "says": "Last updated 2025-10-01" }, { "key": "terms.law", "label": "Names the governing law or courts", "found": false }, { "key": "terms.liability", "label": "States a limit on its liability", "found": true, "quote": "WE MAKE NO WARRANTIES, EXPRESS OR IMPLIED, GUARANTEES OR CONDITIONS WITH RESPECT TO YOUR USE OF THE MICROSOFT APIs." }, { "key": "terms.termination", "label": "Says how the agreement or account can be ended", "found": true, "quote": "We may change, amend or terminate these API Terms at any time." }, { "key": "terms.changes", "label": "Says how changes to the terms are announced", "found": true, "quote": "WE MAY MODIFY THESE API TERMS AT ANY TIME, WITH OR WITHOUT PRIOR NOTICE TO YOU.", "says": "Says it gives notice of a change" }, { "key": "terms.use", "label": "Lists what users may not do", "found": true, "quote": "Unless you have use permissions expressly and specifically granted by Customers in connection with using your Application, you may not use Microsoft email protocols and APIs for any purpose other than:" }, { "key": "terms.sla", "label": "Refers to a service level or uptime commitment", "found": false } ], "toKnow": [ { "key": "terms.automated", "label": "Restricts automated access", "found": true, "quote": "Scrape, build databases or otherwise create copies of any data accessed or obtained using the Microsoft APIs, except as necessary to enable an intended usage scenario for your Application;", "costsPoints": true }, { "key": "terms.benchmark", "label": "Restricts benchmarking or competitive use", "found": true, "quote": "Use the Microsoft APIs, or any data obtained using the Microsoft APIs, to conduct performance testing of a Microsoft Offering unless expressly permitted by Microsoft", "costsPoints": true }, { "key": "terms.nonotice", "label": "Says the terms or the service can change without notice", "found": true, "quote": "WE MAY MODIFY THESE API TERMS AT ANY TIME, WITH OR WITHOUT PRIOR NOTICE TO YOU.", "costsPoints": true }, { "key": "terms.cutoff", "label": "Says access can be ended without notice or for any reason", "found": true, "quote": "We may suspend or immediately terminate these API Terms, any rights granted herein, and/or your license to the Microsoft APIs, in our sole discretion at any time, for any reason." } ], "notes": [ { "date": "2026-10-08", "text": "Recoverable damages are limited to direct damages of up to 5 US dollars in total.", "quote": "YOU AGREE THAT YOUR EXCLUSIVE REMEDY IS TO RECOVER, FROM MICROSOFT OR ANY AFFILIATES, RESELLERS, DISTRIBUTORS, SUPPLIERS (AND RESPECTIVE EMPLOYEES, SHAREHOLDERS, OR DIRECTORS) AND VENDORS, ONLY DIRECT DAMAGES UP TO USD $5.00 COLLECTIVELY." }, { "date": "2026-10-08", "text": "After a data breach involving the Microsoft APIs, the developer may make no public statement about it without Microsoft's prior written permission.", "quote": "You agree to refrain from making public statements (e.g., press, blogs, social media, bulletin boards, etc.) without prior written and express permission from Microsoft in each instance as it relates to the Microsoft APIs." }, { "date": "2026-10-08", "text": "The developer must allow Microsoft reasonable access to its application so Microsoft can monitor compliance with the API terms.", "quote": "You will permit Microsoft reasonable access to your Application for purposes of monitoring compliance with these API Terms." } ] }, { "kind": "privacy", "url": "https://privacy.microsoft.com/en-us/privacystatement", "state": "read", "readAt": "2026-10-08", "statedDate": "2026-09-01", "words": 33580, "points": 8, "max": 10, "expected": [ { "key": "privacy.date", "label": "Gives the date it was last updated", "found": true, "quote": "Last Updated: September 2026", "says": "Last updated 2026-09-01" }, { "key": "privacy.collected", "label": "Says what personal data is collected", "found": true, "quote": "The data we collect depends on the context of your interactions with Microsoft and the choices you make, including your privacy settings and the products and features you use." }, { "key": "privacy.retention", "label": "Says how long data is kept", "found": true, "quote": "When you delete an email or item from a mailbox in Outlook.com, the item generally goes into your Deleted Items folder where it remains for approximately 7 days unless you move it back to your inbox, you empty the folder, or the service empties the folder automatically, whichever comes first.", "says": "Names a period of 7 days" }, { "key": "privacy.processors", "label": "Says who else receives the data", "found": true, "quote": "Service providers that help us determine your device’s location." }, { "key": "privacy.sale", "label": "Says whether personal data is sold or shared for advertising", "found": true, "quote": "not use or share student personal data for advertising or similar commercial purposes, such as providing personalized advertising to students;" }, { "key": "privacy.rights", "label": "Says what rights people have over their data", "found": true, "quote": "State Data Privacy Notice (including notice at collection details) and the Consumer Health Data Privacy Policy for additional information about your rights and the processing of your personal data." }, { "key": "privacy.contact", "label": "Gives a privacy contact", "found": true, "quote": "If you have a privacy concern, complaint, or question for the Microsoft privacy team or Data Protection Officer, please visit our privacy support and requests page and click on “Contact the Microsoft privacy team or the Microsoft Data Protection Officer” menu.", "says": "Names a data protection officer" }, { "key": "privacy.transfers", "label": "Says where data is transferred or stored", "found": true, "quote": "In such cases, we implement legal safeguards-such as standard contractual clauses approved by the European Commission – to help protect your rights and ensure your data remains protected.", "says": "Relies on standard contractual clauses" } ], "toKnow": [ { "key": "training", "label": "Says it may use customer content to train or improve models, and no opt-out was found", "found": true, "quote": "As part of our efforts to improve and develop our products, we may use your data to develop and train our AI models.", "costsPoints": true }, { "key": "privacy.sells", "label": "Says it sells personal data or shares it for advertising", "found": true, "quote": "We also disclose personal data for digital advertising purposes." } ], "notes": [ { "date": "2026-10-08", "text": "For enterprise and developer products, the customer's agreement with Microsoft takes precedence over this privacy statement where the two conflict.", "quote": "In the event of a conflict between our privacy statement and the terms of any agreement(s) between a customer and Microsoft for Enterprise and Developer Products, the terms of those agreement(s) will control." }, { "date": "2026-10-08", "text": "Advertisements may be chosen from the current interaction, including Copilot conversations and files shared in them.", "quote": "Ads may be shown that relate to the current interaction you are having with us, such as your Copilot conversations (including files you share); your current location; transactions; product usage; search queries; or the content you’re viewing." }, { "date": "2026-10-08", "text": "Microsoft staff manually review some results of automated systems, including AI, against the source data.", "quote": "For example, to build, train, and improve the accuracy of our automated systems – such as AI - we manually review some of the results against the underlying data." } ] } ] }, "pageJsonUrl": "https://www.anchorterminal.com/tools/microsoft-teams.json", "live": { "slug": "microsoft-teams", "probe": { "target": "https://graph.microsoft.com/v1.0", "method": "get", "lastAt": "2026-10-08T21:12:15.739217411Z", "lastOk": true, "lastStatus": 200, "lastMs": 8, "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 5, "p95ms24h": 20, "samples24h": 21, "samples30d": 21, "days": [ { "date": "2026-10-08", "probes": 21, "ok": 21 } ] }, "updatedAt": "2026-10-08T21:12:15.739217411Z" } } }