プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

AImart Parquet

作者:balogvnバージョン 0.1.3i★ 0iパソコンでもクラウドでもリポジトリ ↗
レジストリ名io.github.balogvn/aimart-parquet

インストール方法

What it does

Messy CSV, JSON, Excel, SPSS/Stata/SAS and PDF tables to typed Parquet; inspect, query, join.

  • Connects パソコンでもクラウドでも
  • Account or key No key needed
  • Category 文書・表計算・事務作業

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9191 個の skill

Skill · 手順書ライセンス記載なし

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7231 個の skill

Skill · 手順書

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,104 (whole repo)5 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

AImart Parquet をインストールして。https://mcp.popnx.com/i/balogvn-aimart-parquet.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(balogvn--aimart-parquet.us-east.modal.run)を通ります · ✓ コマンド確認済み 2026年11月18日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前AImart Parquet
    Remote MCP server URL · アドレスhttps://balogvn--aimart-parquet.us-east.modal.run/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsAImart Parquet

  4. 試してみる

    AImart Parquet を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が AImart Parquet を使っていると言うか、回答に AImart Parquet のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前AImart Parquet
    Connection · アドレスhttps://balogvn--aimart-parquet.us-east.modal.run/mcp
  3. チャットで AImart Parquet を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から AImart Parquet を選びます

  4. 試してみる

    AImart Parquet を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が AImart Parquet を使っていると言うか、回答に AImart Parquet のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user aimart-parquet https://balogvn--aimart-parquet.us-east.modal.run/mcp
  3. Claude Code で /mcp と入力

    AImart Parquet が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    AImart Parquet を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が AImart Parquet を使っていると言うか、回答に AImart Parquet のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    AImart Parquet を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が AImart Parquet を使っていると言うか、回答に AImart Parquet のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    AImart Parquet を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が AImart Parquet を使っていると言うか、回答に AImart Parquet のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://balogvn--aimart-parquet.us-east.modal.run/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?AImart Parquet を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user aimart-parquet https://balogvn--aimart-parquet.us-east.modal.run/mcp

Cursor (~/.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 mcp

Claude 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"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンでもクラウドでも
最新バージョンi
0.1.3
レジストリ公開日i
2026年11月18日
コードの最終更新i
2026年11月18日
最終確認
2026年11月17日
作者
balogvn
パッケージ
pypi: aimart-parquet
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月17日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • convert_to_parquet

    Convert 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_parquet

    Describe 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_parquet

    Return 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_parquet

    Run 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_provenance

    Free. 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_capability

    Free. 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

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント balogvn で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • ✓ 合格

    エンドポイントが応答する

    280ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    6件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/balogvn-aimart-parquet.svg)](https://mcp.popnx.com/en/servers/balogvn-aimart-parquet)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

文書・表計算・事務作業のほかのサーバーとの比較i

  • このカテゴリのほかの4126件のうち0%よりスターが多い
  • このカテゴリのほかの4126件のうち93%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの4126件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

AImart Parquetは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.1.3)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter広く使われている★ 4.4万5 か月前更新

クラウドで動く✓ 提供元 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry広く使われている↓ 13万/週 共有パッケージの数★ 65884 か月前更新

パソコンで動く✓ 提供元 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai広く使われている★ 29942 か月前更新

クラウドで動く✓ 提供元 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp成長中↓ 1136/週★ 567先月更新

パソコンで動く✓ 提供元 · ankimcp.ai
似たものと比べる
これ
AImart Parquet
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック5/54/43/32/44/43/3
ライセンスApache-2.0AGPL-3.0MITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。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_rawestimated_tokens_schema
3-row, 2-column CSV918
100,000-row, 6-column synthetic CSV (4.2 MB → 0.6 MB Parquet)1,044,27159

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/list works 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.

operationRESTMCP toolprice
convertPOST /v1/convert, POST /v1/convert/upload (multipart)convert_to_parquet$0.02
inspect (footer only)POST /v1/inspectinspect_parquet$0.002
previewPOST /v1/previewpreview_parquet$0.002
query (one read-only SELECT; up to 8 tables: data plus up to 7 more in tables)POST /v1/queryquery_parquet$0.005
premium (off by default): quantum-kernel PCAPOST /v1/quantum/compressquantum_compress_features$0.50
premium (off by default): QAOA portfolioPOST /v1/quantum/portfolioquantum_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

冒頭だけを表示しています。続きはリポジトリで読めます