ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ คลาวด์หรือติดตั้งในเครื่อง
- บัญชีหรือคีย์ ไม่ต้องใส่คีย์
- หมวด เอกสาร ตาราง และงานออฟฟิศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Messy CSV, JSON, Excel, SPSS/Stata/SAS and PDF tables to typed Parquet; inspect, query, join.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
watermarks-remover
watermarks-remover เป็นแอปที่เน้นความเป็นส่วนตัว ใช้สำหรับลบลายน้ำ AI ออกจากเนื้อหาที่ผู้ใช้เป็นเจ้าของ
obsidian-skills
obsidian-skills คือชุดทักษะสำหรับ AI เพื่อให้ใช้งาน Obsidian CLI และรูปแบบไฟล์ของ Obsidian ได้ เช่น Markdown, Bases และ JSON Canvas
ทำไมอยู่อันดับนี้
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 8/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 20/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง AImart Parquet ให้หน่อย ทำตาม https://mcp.popnx.com/i/balogvn-aimart-parquet.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (balogvn--aimart-parquet.us-east.modal.run) · ✓ ตรวจคำสั่งแล้ว 18 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
เปิดหน้า Connectors ของ Claude
CustomizeConnectors
กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
Name · ชื่อAImart ParquetRemote MCP server URL · ที่อยู่https://balogvn--aimart-parquet.us-east.modal.run/mcpกด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
เปิดใช้ในแชต
+ConnectorsAImart Parquet
ลองเลย
ใช้ AImart Parquet บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ AImart Parquet หรือมีชื่อเครื่องมือของ AImart Parquet ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ
Plugins+Add custom MCP server
กรอกชื่อและที่อยู่
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
Name · ชื่อAImart ParquetConnection · ที่อยู่https://balogvn--aimart-parquet.us-east.modal.run/mcpเลือก AImart Parquet ในแชต
เปิดแชตใหม่แล้วเลือก AImart Parquet จากรายการปลั๊กอินก่อนพิมพ์
ลองเลย
ใช้ AImart Parquet บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ AImart Parquet หรือมีชื่อเครื่องมือของ AImart Parquet ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
claude mcp add --transport http --scope user aimart-parquet https://balogvn--aimart-parquet.us-east.modal.run/mcpพิมพ์ /mcp ใน Claude Code
ต้องเห็น AImart Parquet ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ AImart Parquet บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ AImart Parquet หรือมีชื่อเครื่องมือของ AImart Parquet ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ AImart Parquet บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ AImart Parquet หรือมีชื่อเครื่องมือของ AImart Parquet ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ AImart Parquet บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ AImart Parquet หรือมีชื่อเครื่องมือของ AImart Parquet ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://balogvn--aimart-parquet.us-east.modal.run/mcpค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ต่อผ่านเว็บ
Claude Code
claude mcp add --transport http --scope user aimart-parquet https://balogvn--aimart-parquet.us-east.modal.run/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"aimart-parquet": {
"url": "https://balogvn--aimart-parquet.us-east.modal.run/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"aimart-parquet": {
"type": "http",
"url": "https://balogvn--aimart-parquet.us-east.modal.run/mcp"
}
}
}ติดตั้งในเครื่อง
Claude Code
claude mcp add --scope user aimart-parquet -- uvx aimart-parquet mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"aimart-parquet": {
"command": "uvx",
"args": [
"aimart-parquet",
"mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"aimart-parquet": {
"command": "uvx",
"args": [
"aimart-parquet",
"mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"aimart-parquet": {
"type": "stdio",
"command": "uvx",
"args": [
"aimart-parquet",
"mcp"
]
}
}
}ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
- ดาวน์โหลดต่อสัปดาห์i
- ไม่มียอดใน npm/PyPI
- การเชื่อมต่อ
- บนเครื่องหรือคลาวด์
- ช่องทาง (transport)
- stdio, streamable-http
- รุ่นล่าสุดi
- 0.1.3
- ส่งเข้า registryi
- 18 พ.ย. 2569
- แก้โค้ดล่าสุดi
- 18 พ.ย. 2569
- ตรวจล่าสุดเมื่อ
- 17 พ.ย. 2569
- ผู้ทำ
- balogvn
- แพ็กเกจ
pypi: aimart-parquet- เว็บผู้ทำ
- github.com
- สถานะใน registry
- ใช้งานอยู่
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 17 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน
convert_to_parquetConvert a messy data file into clean, typed, zstd-compressed Parquet. Use this first for any CSV/TSV, JSON/NDJSON, Excel, SPSS, Stata or SAS file, or a digital PDF with tables. It detects the format, encoding and delimiter; skips title rows; repairs broken JSON; pulls tables out
inspect_parquetDescribe a Parquet file from its footer without reading rows: row count, columns, types, null counts, min/max per column, and SPSS/Stata/SAS labels. The cheapest way to understand a dataset before querying it. Input: artifact_id from convert_to_parquet, or a url to a .parquet fil
preview_parquetReturn a slice of rows from a Parquet file (default 20, max 500), optionally only some columns, as JSON rows, a Markdown table, or CSV. Use to eyeball data; use query_parquet to filter or aggregate. Long cells are truncated. Price: $0.002 USDC per successful call, paid via x402.
query_parquetRun one read-only DuckDB SELECT over a Parquet file, available as table `data`; join more files by passing `tables` ({name: artifact_id}, up to 7 besides data), e.g. a GL against a bank statement. Supports aggregates, window functions, CTEs, DESCRIBE data and SUMMARIZE data. Up t
verify_provenanceFree. Check that a file this service produced is authentic and unaltered: verifies the post-quantum ML-DSA-65 (NIST FIPS 204) signature in an artifact's `provenance`, and with artifact_id also re-checks the stored file's hash and size against the signed manifest.
request_capabilityFree. If none of these tools does what you need — a file type we reject, an output we do not produce, a missing operation — describe the task, the formats involved, and the most you would pay per call. The operator reads these to decide what to build next. Do not include personal
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub balogvn ซึ่งเป็นเจ้าของ repo
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด เมื่อวาน
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ Apache-2.0
- ✓ ผ่าน
endpoint ตอบ
ตอบกลับใน 280 ms (HTTP 200)
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ไม่ต้องล็อกอิน
- ✓ ผ่าน
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
อ่านคำอธิบายเครื่องมือ 6 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI
ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)
ยังไม่ได้ตรวจ
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/balogvn-aimart-parquet)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi
- ดาวมากกว่า 0% ของอีก 4126 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 93% ของอีก 4126 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 4126 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
AImart Parquet ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวาน และส่งรุ่นล่าสุด (0.1.3) เข้า registry เมื่อวาน
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
ตัวอื่นที่ทำงานคล้ายกัน
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP
ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator
Vexa
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Atlassian Rovo MCP Server
server ทางการของ Atlassian ให้ AI ค้นและจัดการงานใน Jira และเอกสารใน Confluence ต่อผ่านคลาวด์และล็อกอินแบบ OAuth
Anki MCP Server
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| ตัวนี้ AImart Parquet | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง |
| ต้องใส่คีย์ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 5/5 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| สัญญาอนุญาต | Apache-2.0 | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
AImart Parquet
Messy data in, clean Parquet out, paid per call by AI agents.
AImart Parquet is an MCP server and REST API that turns messy CSV/TSV, JSON/NDJSON, Excel, SPSS, Stata and SAS files, and tables in digital PDFs, into clean, typed, zstd-compressed Parquet. You can then inspect the result (footer only), preview rows, and query it with sandboxed, read-only DuckDB SQL, including joins across several files. Agents pay per call in USDC with x402 v2. There is no signup and no API key.
Predictable for agents: each operation has a fixed price, so an agent's spend cap is exact, and a call that fails is not charged. Every paid call returns a receipt naming its on-chain transaction (the PAYMENT-RESPONSE header, or x402/payment-response over MCP), and every file the hosted service produces carries a signed provenance record (ML-DSA-65) that proves it came unaltered from the service (how to verify).
Live: the hosted service is at https://balogvn--aimart-parquet.us-east.modal.run and takes USDC on Base mainnet. Its MCP endpoint is https://balogvn--aimart-parquet.us-east.modal.run/mcp. Prices, limits and data handling, as that service applies them, are at /pricing and /llms.txt. The package is on PyPI (uvx aimart-parquet mcp runs the free local server), and the server is in the official MCP Registry as io.github.balogvn/aimart-parquet.
Your data: inputs are deleted when the call ends. Converted files become unreachable after 60 minutes and are deleted by a cleanup that runs when the service starts and once a minute while it runs. The hosted service stops when idle, so one that expires while it is stopped stays stored, unreachable, until it next starts: normally within a day. A deployment that keeps outputs in Cloud Storage has a worst case of about a day (the bucket's 1-day lifecycle rule). File contents are never logged or used for training. Details: docs/privacy.md.
Why it exists: an agent that reads a 100,000-row CSV as text spends a large share of its context on raw rows. With this service it reads a compact schema report and then asks targeted SQL questions. Every conversion reports two rough numbers so you can judge the trade-off for your own data: estimated_tokens_raw (input text bytes / 4) and estimated_tokens_schema (a column digest of name, type and null count, / 4). The ratio depends on rows × columns, so there is no fixed saving:
input (measured with aimart-parquet convert) | estimated_tokens_raw | estimated_tokens_schema |
|---|---|---|
| 3-row, 2-column CSV | 9 | 18 |
| 100,000-row, 6-column synthetic CSV (4.2 MB → 0.6 MB Parquet) | 1,044,271 | 59 |
For tiny files the report costs more than the file, so just read those directly. The schema estimate covers only the column digest. The full JSON response is larger: it adds per-column notes and, on the hosted service, a provenance block with a 3,309-byte ML-DSA-65 signature (4,412 base64 characters).
The examples below call the hosted service, so a paid one spends real USDC (two cents for a
conversion). An unpaid call costs nothing and shows the price. If you run your own deployment
(hosting), use its URL instead.
Contents
- Quickstart for agents
- Pricing
- Supported formats
- Limits and errors
- Premium quantum tier
- Post-quantum provenance
- Security model
- Hosting
- Development
- Documentation
Quickstart for agents
The typical flow is: convert_to_parquet returns an artifact_id and a schema report. Then inspect_parquet or preview_parquet lets you look, and query_parquet answers questions with SQL. Pass the artifact_id between calls instead of re-sending the file. Inputs are a public url (best for large files), content_base64 plus filename (under about 3 MB), or the artifact_id of a file converted earlier (convert takes one too, to convert it again with new options). Over MCP only convert_to_parquet takes content_base64; on REST, convert, inspect, preview and query take all three.
REST: 402 → decode → pay → retry
An unpaid call returns HTTP 402 with an empty body. The quote is in the base64 PAYMENT-REQUIRED header:
URL=https://balogvn--aimart-parquet.us-east.modal.run # the hosted service
curl -s -D - -o /dev/null -X POST "$URL/v1/convert" \ -H 'content-type: application/json' \ -d '{"url": "https://raw.githubusercontent.com/balogvn/aimart/main/docs/examples/sales.csv"}' \ | awk 'tolower($1) == "payment-required:" {print $2}' | tr -d '\r' | base64 --decode | jq .
{
"x402Version": 2, "error": "Payment required", "resource": {"url": "https://balogvn--aimart-parquet.us-east.modal.run/v1/convert", "mimeType": "application/json", "...": "..."}, "accepts": [{ "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "20000", "payTo": "0x…", "maxTimeoutSeconds": 300, "extra": {"name": "USD Coin", "version": "2"} }] }
network is Base mainnet and asset is USDC there. amount is in USDC atomic units (6 decimals): 20000 is $0.02. curl cannot sign. An x402 client signs the quote with your wallet and retries with a PAYMENT-SIGNATURE header. The settlement comes back in PAYMENT-RESPONSE. The payer needs USDC on Base and nothing else: the facilitator pays the network fee. With the x402 Python SDK (pip install "x402[evm,httpx]"), this spends $0.025 of real USDC, two cents to convert and half a cent to query:
import os
import anyio import httpx from eth_account import Account from x402 import max_amount, x402Client from x402.http.clients.httpx import x402AsyncTransport from x402.mechanisms.evm import EthAccountSigner from x402.mechanisms.evm.exact import ExactEvmClientScheme
URL = "https://balogvn--aimart-parquet.us-east.modal.run" # the hosted service, on Base mainnet KEY = os.environ["PAYER_PRIVATE_KEY"] # a wallet holding a little USDC on Base; stays on your side
payer = x402Client() payer.register("eip155:8453", ExactEvmClientScheme(EthAccountSigner(Account.from_key(KEY)))) payer.register_policy(max_amount(20_000)) # never pay more than $0.02 per call
async def main() -> None: transport = x402AsyncTransport(payer, httpx.AsyncHTTPTransport()) async with httpx.AsyncClient(base_url=URL, transport=transport, timeout=180) as http:
A 6-row sample from this repository; put your own file's public URL here.
sample = "https://raw.githubusercontent.com/balogvn/aimart/main/docs/examples/sales.csv" r = await http.post("/v1/convert", json={"url": sample}) artifact_id = r.json()"artifact" r = await http.post( "/v1/query", json={ "artifact_id": artifact_id, "sql": "SELECT region, sum(units) FROM data GROUP BY 1", }, ) print(r.json()["rows"])
anyio.run(main)
A complete, tested script for REST, MCP and provenance checks is in docs/examples/agent_pays.py. The step-by-step guide is in docs/agents-guide.md. If a paid retry still returns 402, the body is again {} and the reason is in the PAYMENT-REQUIRED header's error field.
MCP
The remote server speaks Streamable HTTP at /mcp. initialize and tools/list are free. Each paid tools/call is charged through x402's MCP transport: an unpaid call returns isError: true with the PaymentRequired object in structuredContent, and the client retries with the signed payload in params._meta["x402/payment"].
Claude Code:
claude mcp add --transport http aimart https://balogvn--aimart-parquet.us-east.modal.run/mcp
Cursor, or any client that takes a remote URL (.cursor/mcp.json or equivalent):
{ "mcpServers": { "aimart": { "url": "https://balogvn--aimart-parquet.us-east.modal.run/mcp" } } }
Free local server over stdio, for files on your machine. It needs no payments, no wallet and no network:
claude mcp add aimart-local -- uvx aimart-parquet mcp
with the quantum tools:
claude mcp add aimart-local -e AIMART_ENABLE_QUANTUM=true -- uvx --from 'aimart-parquet[quantum]' aimart-parquet mcp
{ "mcpServers": { "aimart-local": { "command": "uvx", "args": ["aimart-parquet", "mcp"] } } }
Local mode takes path inputs and writes the output next to the input, or to output_path. If AIMART_HOSTED_URL is set, convert results include a one-line hint that points at the hosted service, which adds signed provenance.
Paying from an MCP host. Today most MCP hosts do not sign x402 payments by themselves.
In those hosts,
tools/listworks and paid tools return the PaymentRequired error result.
To pay over MCP you need an x402-capable MCP client, such as the Python client in
docs/agents-guide.md. The local server never asks for payment.
Joins
One query reads up to 8 tables in total: the top-level input is table data, and tables adds up to 7 more by name, for one query price. REST takes an object per table (artifact_id, or url of a Parquet file); the MCP tool takes the artifact_id string itself (a local path in local mode). With sql = SELECT d.*, o.status FROM data d JOIN orders o USING (order_id):
REST POST /v1/query {"artifact_id": "<invoices_id>", "sql": "...", "tables": {"orders": {"artifact_id": "<orders_id>"}}}
MCP query_parquet {"artifact_id": " ", "sql": "...", "tables": {"orders": " "}}
Pricing
Prices are the Settings defaults, in USDC per successful call. A call that fails (HTTP ≥ 400, or an MCP isError result) is never settled, so you are not charged for errors. A deployment can override each price with AIMART_PRICE_*. Its live list is at GET /pricing.
| operation | REST | MCP tool | price |
|---|---|---|---|
| convert | POST /v1/convert, POST /v1/convert/upload (multipart) | convert_to_parquet | $0.02 |
| inspect (footer only) | POST /v1/inspect | inspect_parquet | $0.002 |
| preview | POST /v1/preview | preview_parquet | $0.002 |
query (one read-only SELECT; up to 8 tables: data plus up to 7 more in tables) | POST /v1/query | query_parquet | $0.005 |
| premium (off by default): quantum-kernel PCA | POST /v1/quantum/compress | quantum_compress_features | $0.50 |
| premium (off by default): QAOA portfolio | POST /v1/quantum/portfolio | quantum_optimize_portfolio | $1.00 |
Free: GET /, /health, /pricing, /llms.txt, /openapi.json, /docs, /.well-known/x402, /.well-known/mcp/server-card.json, /.well-known/aimart-signing-key, POST /v1/verify and the verify_provenance tool, POST /v1/feedback and the request_capability tool (tell us what you needed and would pay for), signed artifact downloads (GET /v1/artifacts/{id}/{filename}?exp&sig), MCP initialize and tools/list, and the whole local stdio server.
The floor is $0.002 because facilitators reject payments below about $0.0011–0.0015, and some charge up to about $0.002 per settlement. Below that floor a call is either unsettleable or loss-making. See docs/economics.md.
Networks: the hosted service takes USDC on Base mainnet (eip155:8453), settled through xpay, with Primer as the fallback. The software's own default is testnet (Base Sepolia eip155:84532, facilitator https://x402.org/facilitator): mainnet (Base via xpa