# update_kpi_metric

A write tool on the Aos MCP server.

Agent View of the PolicyLayer registry record for `update_kpi_metric`. HTML page: https://policylayer.com/tools/funny-booth-aos-mcp-server/update-kpi-metric

## Facts

- Tool: `update_kpi_metric`
- Server: Aos (`@funny-booth/aos-mcp-server`) — https://policylayer.com/tools/funny-booth-aos-mcp-server.md
- Install: `npx -y @funny-booth/aos-mcp-server`
- Homepage: https://www.npmjs.com/package/@funny-booth/aos-mcp-server
- Risk category: Write (Medium risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 7 (1 required)
- Recommended policy verdict: Rate-limited

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | 指標ID |
| `name` | string | no |  |
| `unit` | string | null | no |  |
| `owner_id` | string | no |  |
| `is_active` | boolean | no |  |
| `target_value` | number | no |  |
| `target_direction` | string | no |  |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_kpi_metric",
    "arguments": {
      "id": "<id>"
    }
  }
}
```

## Why update_kpi_metric is rated Medium

The tool modifies existing KPI metric records, making it a Write action. Severity is medium because misuse could corrupt business metrics and reporting systems, but the impact is reversible (can be corrected with another update). Confidence is 0.85 rather than higher due to empty description, but the verb `update` combined with the domain context of KPI management strongly indicates a Write operation.

From the tool's own definition: "Tool name `update_kpi_metric` indicates modification of key performance indicator data. Sibling tools include `create_kpi_metric`, confirming this server manages KPI entities. The `update_` prefix clearly denotes a write operation."

## Use case

AI agents use update_kpi_metric to create or update resources in Aos, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Aos environment.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Aos:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "update_kpi_metric": {
      "limits": [
        {
          "counter": "update_kpi_metric_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Aos (36)

- `delete_backlog_item` — Destructive — https://policylayer.com/tools/funny-booth-aos-mcp-server/delete-backlog-item.md
- `delete_kpi_entry` — Destructive — https://policylayer.com/tools/funny-booth-aos-mcp-server/delete-kpi-entry.md
- `get_activity_logs` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-activity-logs.md
- `get_backlog` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-backlog.md
- `get_briefing` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-briefing.md
- `get_issues` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-issues.md
- `get_kpi` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-kpi.md
- `get_members` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-members.md
- `get_missions` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-missions.md
- `get_org_chart` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-org-chart.md
- `get_seat` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-seat.md
- `get_strategy` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-strategy.md
- `get_tasks` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-tasks.md
- `get_todos` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/get-todos.md
- `list_teams` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/list-teams.md
- `whoami` — Read — https://policylayer.com/tools/funny-booth-aos-mcp-server/whoami.md
- `complete_task` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/complete-task.md
- `complete_todo` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/complete-todo.md
- `create_backlog_item` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-backlog-item.md
- `create_issue` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-issue.md
- `create_kpi_metric` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-kpi-metric.md
- `create_member` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-member.md
- `create_mission` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-mission.md
- `create_task` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-task.md
- `create_team` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-team.md
- `create_todo` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/create-todo.md
- `invite_to_team` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/invite-to-team.md
- `log_activity` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/log-activity.md
- `reject_task` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/reject-task.md
- `update_backlog_item` — Write — https://policylayer.com/tools/funny-booth-aos-mcp-server/update-backlog-item.md
- …and 6 more: https://policylayer.com/tools/funny-booth-aos-mcp-server.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=funny-booth-aos-mcp-server · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/funny-booth-aos-mcp-server