Skip to content

feat(coinbase-mcp): add agent controls guidance for orders and payments - #21

Open
apmcdermott wants to merge 1 commit into
mainfrom
feat/mcp-agent-controls-guidance
Open

apmcdermott wants to merge 1 commit into
mainfrom
feat/mcp-agent-controls-guidance

Conversation

@apmcdermott

Copy link
Copy Markdown

Description

Coinbase MCP is adding coinbase_agent_controls_get, a read-only tool that returns the user's agent spend limits (orders and x402 payments) and whether the user's automatic stop has paused the app. This adds guidance so agents check it before they preview an order or pay for research, instead of finding out from a refusal.

  • references/trading.md: read the controls in step 1, stop on pause_status: yes, treat unknown as possibly paused, compare the order with max (per order) or remaining (rolling), and remember the snapshot is advisory. Adds a row to the MCP tool table.
  • references/x402.md: check x402_payment limits and pause before paying.
  • SKILL.md: a spend-limit or paused refusal is the user's control; don't split or reroute to get around it.
  • Changelog entry under 0.0.2.

All of it is conditional on the server exposing the tool, so it is safe to merge before the tool is live on /mcp and /mcp/chatgpt.

Change type

  • Harness integration or metadata
  • Skill workflow
  • Bug fix
  • Documentation
  • Breaking change (describe migration)

Validation

  • python3 -m unittest discover -s tests: 38 tests OK.

  • python3 scripts/build-distributions.py: builds; the new guidance appears in the portable, Claude, Codex and ChatGPT packages, and ChatGPT still omits x402.md.

  • Not run: native harness loading or an authenticated smoke test. The tool is not live yet, so I could not check its exposed schema through tools/list.

  • Generated portable manifest and MCP config validate against the vendored Agent Plugins schemas

  • Package paths and skill references remain inside each generated plugin root

  • Marketplace, skills, MCP, and icon paths are valid

  • Exactly one canonical skill library; generated copies are not committed

  • Claude compatibility metadata/endpoint and marketplace sources agree with the portable package

  • Tool schemas, authorization, and retry behavior reviewed (field names match the tool's current contract; recheck against tools/list once it is live)

  • README and changelog updated; versions consistent

  • No unapproved disclosures or sensitive data

  • Signed commits

Release considerations

Ship after the tool is live on the hosted MCP endpoints, or rely on the "where exposed" wording until then.

@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
1 if authored by an app that is not allowlisted and lacks verified human attribution 0
Sum 1

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants