get_total_burnchain_rewards

Get total burnchain rewards earned by a Bitcoin address

Server Stacks AI MCP Server stack-ai-mcp/stacks-mcp-server
Category Read
Risk class Low
Parameters 00 required

What get_total_burnchain_rewards does on Stacks AI MCP Server

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

Why get_total_burnchain_rewards needs a policy

This tool queries existing blockchain data to retrieve reward information for a given address. It has no side effects, makes no modifications to state, executes no code, and incurs no financial obligations. It is a straightforward read operation with minimal blast radius if misused by an AI agent—worst case, it could retrieve reward data for an address it shouldn't, but no destructive or financial harm results.

From the tool's definition Tool name 'get_total_burnchain_rewards' and description 'Get total burnchain rewards earned by a Bitcoin address' indicate a query operation that retrieves blockchain reward data.

Questions about get_total_burnchain_rewards

What does the get_total_burnchain_rewards tool do? +

Get total burnchain rewards earned by a Bitcoin address. It is categorised as a Read tool in the Stacks AI MCP Server MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on get_total_burnchain_rewards? +

Register the Stacks AI MCP Server MCP server in PolicyLayer and add a rule for get_total_burnchain_rewards: 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 Stacks AI MCP Server. Nothing to install.

What risk level is get_total_burnchain_rewards? +

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

Can I rate-limit get_total_burnchain_rewards? +

Yes. Add a rate_limit block to the get_total_burnchain_rewards 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 get_total_burnchain_rewards completely? +

Set action: deny in the PolicyLayer policy for get_total_burnchain_rewards. 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 get_total_burnchain_rewards? +

get_total_burnchain_rewards is provided by the Stacks AI MCP Server MCP server (stack-ai-mcp/stacks-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

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

Message sent.

We'll get back to you soon.