Low Risk

matrix_federation_health

Ask the public Matrix Federation Tester (federationtester.matrix.org) whether this server federates correctly. Exercises both .well-known delegation and :8448 reachability — the canonical test for new Matrix installs.

How to control matrix_federation_health ↓

What matrix_federation_health does on Crow

AI agents call matrix_federation_health to retrieve information from Crow without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Low Risk

Why matrix_federation_health needs a policy

This tool retrieves diagnostic information about server federation health via a read-only query to a public testing service. It has no side effects, does not modify configuration, and does not execute arbitrary code. It is a diagnostic/monitoring operation that falls squarely into the Read category.

From the tool's definition Tool makes queries to an external testing service (federationtester.matrix.org) to check federation status.

Documented attack patterns abuse exactly the kind of access matrix_federation_health gives an agent:

How to control matrix_federation_health

PolicyLayer is an MCP gateway — it sits between your AI agents and Crow, and nothing reaches the server without passing your rules. This is the rule we recommend for matrix_federation_health:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "matrix_federation_health": {}
  }
}

matrix_federation_health is read-only, so it stays allowed — but everything else on the server is denied unless you say otherwise.

  1. Create a free account and register Crow — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
CAP THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about matrix_federation_health

What does the matrix_federation_health tool do? +

Ask the public Matrix Federation Tester (federationtester.matrix.org) whether this server federates correctly. Exercises both .well-known delegation and :8448 reachability — the canonical test for new Matrix installs. It is categorised as a Read tool in the Crow MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on matrix_federation_health? +

Register the Crow MCP server in PolicyLayer and add a rule for matrix_federation_health: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Crow. Nothing to install.

What risk level is matrix_federation_health? +

matrix_federation_health is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit matrix_federation_health? +

Yes. Add a rate_limit block to the matrix_federation_health rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block matrix_federation_health completely? +

Set action: deny in the PolicyLayer policy for matrix_federation_health. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides matrix_federation_health? +

matrix_federation_health is provided by the Crow MCP server (kh0pper/crow). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Crow tool call.

Start from Crow, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

576 Crow tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.