# Mangrove developer API and MCP

> Mangrove provides deterministic risk management based on live market and account conditions, alongside strategy, signal, backtesting and execution APIs. Mangrove-owned execution software evaluates live inputs against user policy and enforces the decision in supported workflows, including the local Mangrove Agent where supported. SDKs and connected AI clients submit requests and preserve the result. Verify venue support before claiming enforcement.

## Reference files
- [OpenAPI specification](https://mangrovedeveloper.ai/openapi.json): REST contract in OpenAPI format. Some response schemas are opaque.
- [Execution configuration JSON Schema](https://mangrovedeveloper.ai/execution-config.schema.json): authoring fields and runtime-derived defaults; server validation and runtime policy remain authoritative.
- [Oracle proxy OpenAPI](https://mangrovedeveloper.ai/openapi-oracle.json): separate contract reference.
- [Complete AI integration overview](https://mangrovedeveloper.ai/llms-full.txt): includes onboarding, SDK release state, first calls, authentication, MCP discovery and pricing.
- [Get an API key](https://mangrove.io/developer/api-keys): create and manage API credentials.

## Integration guides
- [Build with AI workflow](https://mangrovedeveloper.ai/llms-full.txt): the full reference contains the copyable prompt and setup sequence.
- [Quickstart and authentication](https://mangrovedeveloper.ai/llms-full.txt): see the full reference for a safe first API read and auth boundary.
- [MangroveAI SDK source](https://github.com/MangroveTechnologies/MangroveAI-SDK): Python and TypeScript client source, with current release status in the full reference.
- [Markets SDK source](https://github.com/MangroveTechnologies/MangroveMarkets): broker, wallet and marketplace workflows, with capabilities that vary by release.
- [Hosted MCP workflow](https://mangrovedeveloper.ai/llms-full.txt): hosted endpoint https://api.mangrovedeveloper.ai/mcp/
- [Local Mangrove Agent](https://github.com/MangroveTechnologies/mangrove-agent): local execution, wallet custody and client setup.

## Discover current capabilities
Use the MCP protocol method tools/list. Request params._meta["mangrove/include_pricing"]=true to include receiver-owned pricing in result._meta["mangrove/pricing"]. Missing pricing means unavailable, not free. The discover_tools tool provides progressive catalog views; inspect its advertised schema before calling it. Hosted and local catalogs differ. Do not assume a fixed tool count or a callable list_tools tool.

## Access and boundaries
REST base: https://api.mangrovedeveloper.ai. Keep keys on your server, outside prompts and browser code. API access depends on the caller's role, scopes and entitlements. Paid compute and x402 payments require explicit authorization; discovery is not permission to spend. Hosted API credentials do not connect a broker or authorize orders. Broker setup and local signing follow their own documented workflow.