---
title: "Agent Token Scope Checker"
method: POST
path: "/v1/tools/check_agent_token_scope"
tags: ["TODO_TAGS_REVIEW"]
---

# Agent Token Scope Checker

`POST /v1/tools/check_agent_token_scope`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/check_agent_token_scope`
- Auth: none declared

Compares a requested agent action (amount, currency, merchant category, timestamp) against an agent token or mandate's declared scope: spend cap, currency, MCC allow-list, and expiry. If an attenuation chain of ancestor tokens is supplied, also checks that each delegation link narrows -- never widens -- the parent's bounds. Returns an in-scope or out-of-scope verdict and receipt. Pure evaluation only -- never authorizes, blocks, or executes a payment. Consumes the same mandate-chain vocabulary as art-01; distinct job -- one requested action against one token's bounds, not full mandate-chain structural validation.

**Tool URL:** https://ainumbers.co/chaingraph/art-385-agent-token-scope-checker.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `attenuation_chain` unknown[], required
    - unknown
  - `requested_action` unknown
  - `token` unknown

## Response `200`

Successful tool execution result

- object
  - `attenuation_depth` integer
  - `checks_run` integer
  - `enforcement` string
  - `failing_checks` unknown[]
    - unknown
  - `token_id` string
  - `verdict` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)