Edit an existing Tako chart via natural language prompt, paid per-call over MPP/Tempo.
What it does
The Tako Charts Edit endpoint (`POST /api/mpp/v1/charts/edit`) lets callers modify an existing data visualization by submitting a natural language instruction. It is part of Tako's broader AI data-visualization and research platform, which includes fast search, deep research, visualization generation, ThinViz cards, and full report generation — all accessible without signup through the MPP (Machine Payment Protocol) 402 flow.
Payment is settled on Tempo L2 (chainId 4217) using pathUSD (6 decimals). The per-call price is 7,333 base units, which equals approximately $0.007333 — well under one cent per edit. The endpoint accepts a JSON POST body, though the exact request schema is not publicly documented beyond the generic `object` type in the OpenAPI spec. The provider's fee-payer flag is set to true, meaning the service covers on-chain gas fees.
Tako positions itself as an AI data analyst that produces interactive, source-cited knowledge cards (charts, tables, maps). The charts/edit endpoint specifically targets iterative refinement of those visualizations: changing colors, labels, chart types, axis ranges, or any other property expressible in plain English. Because the request schema is unspecified, callers will likely need to reference Tako's full documentation at docs.tako.com or the agent manifest at `/.well-known/agent.md` for field-level details.
Capabilities
Use cases
- —Iteratively refine a Tako-generated chart by describing changes in plain English
- —Adjust chart labels, colors, or types programmatically from an AI agent workflow
- —Integrate chart editing into an automated research pipeline that generates and polishes visualizations
Fit
Best for
- —AI agents that need to programmatically refine data visualizations
- —Developers building embedded analytics with iterative chart customization
- —Research workflows that generate charts and then tweak them via natural language
Not for
- —Creating charts from scratch (use /api/mpp/v1/visualize instead)
- —Searching or retrieving raw datasets without visualization
- —Use cases requiring free, unlimited chart edits (each call costs ~$0.0073)
Quick start
curl -X POST https://tako.com/api/mpp/v1/charts/edit \
-H "Content-Type: application/json" \
-H "Authorization: <MPP-Tempo-receipt>" \
-d '{"chart_id": "<existing_chart_id>", "prompt": "Change the bar chart to a line chart and make the title bold"}'Example
Request
{
"prompt": "Change the color scheme to blue and add axis labels",
"chart_id": "abc123"
}Endpoint
Quality
The endpoint is live (402 MPP challenge captured) with clear pricing and settlement details, but the request/response schemas are entirely unspecified (generic `object` in OpenAPI). No dedicated documentation page was reachable, and the example request fields are inferred, not confirmed. Docs at docs.tako.com and /.well-known/agent.md were not crawled.
Warnings
- —Request body schema is unspecified — the OpenAPI spec only declares a generic JSON object. Callers should consult docs.tako.com or /.well-known/agent.md for actual field names.
- —Response schema is completely undocumented; example_response_json is null.
- —The example_request_json fields (chart_id, prompt) are inferred from the endpoint description and are not confirmed by any schema or documentation.
- —The currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on Tempo L2 conventions; if this assumption is wrong the price calculation would differ.
Citations
- —The charts/edit endpoint returns a 402 MPP challenge with method=tempo, intent=charge, amount=7333 on chainId 4217https://tako.com/api/mpp/v1/charts/edit
- —Tako's OpenAPI spec lists /api/mpp/v1/charts/edit as POST with summary 'Edit a chart using a natural language prompt' and price 0.007333https://tako.com
- —Tako describes itself as an AI data analyst that generates interactive knowledge cards from structured datahttps://tako.com
- —Tako pricing tiers range from Free ($0/mo) to Enterprise (custom), with features like Fast Search, Deep Search, and Report Generationhttps://tako.com/pricing
- —Full developer documentation is referenced at docs.tako.com and /.well-known/agent.mdhttps://tako.com