Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

AImart Parquet

von balogvnVersion 0.1.3i★ 0iComputer oder CloudRepository ↗
Name in der Registryio.github.balogvn/aimart-parquet

So installierst du es

What it does

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

  • Connects Computer oder Cloud
  • Account or key No key needed
  • Category Dokumente, Tabellen & Büroarbeit

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

MinerU

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

von opendatalab★ 83.9191 Skills

Skill · AnleitungKeine Lizenz angegeben

watermarks-remover

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

von guillaumemeyer★ 27.7231 Skills

Skill · Anleitung

obsidian-skills

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

von kepano★ 53.104 (whole repo)5 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte AImart Parquet. Folge https://mcp.popnx.com/i/balogvn-aimart-parquet.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (balogvn--aimart-parquet.us-east.modal.run) · ✓ Befehle geprüft am 18. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameAImart Parquet
    Remote MCP server URL · Adressehttps://balogvn--aimart-parquet.us-east.modal.run/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsAImart Parquet

  4. Ausprobieren

    Nutze AImart Parquet und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es AImart Parquet nutzt, oder ein Werkzeug von AImart Parquet in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameAImart Parquet
    Connection · Adressehttps://balogvn--aimart-parquet.us-east.modal.run/mcp
  3. AImart Parquet im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen AImart Parquet aus deinen Plugins wählen

  4. Ausprobieren

    Nutze AImart Parquet und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es AImart Parquet nutzt, oder ein Werkzeug von AImart Parquet in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user aimart-parquet https://balogvn--aimart-parquet.us-east.modal.run/mcp
  3. /mcp in Claude Code eingeben

    AImart Parquet sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze AImart Parquet und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es AImart Parquet nutzt, oder ein Werkzeug von AImart Parquet in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze AImart Parquet und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es AImart Parquet nutzt, oder ein Werkzeug von AImart Parquet in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze AImart Parquet und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es AImart Parquet nutzt, oder ein Werkzeug von AImart Parquet in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://balogvn--aimart-parquet.us-east.modal.run/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die AImart Parquet nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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"
    }
  }
}

Auf deinem Computer installiert

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

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Apache-2.0
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.3
In der Registry veröffentlichti
18. Nov. 2026
Code zuletzt geänderti
18. Nov. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
balogvn
Pakete
pypi: aimart-parquet
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 17. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto balogvn bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 280 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 6 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Dokumente, Tabellen & Büroarbeiti

  • Mehr Sterne als 0 % der anderen 4126 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 93 % der anderen 4126 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 4126 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist AImart Parquet sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.1.3) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Puter MCP

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

von HeyPuterWeit verbreitet★ 44.205Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · puter.com

XcodeBuildMCP

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

von getsentryWeit verbreitet↓ 130.486/Wo. geteiltes Paket★ 6588Aktualisiert vor 4 Monaten

Läuft auf deinem Computer✓ vom Dienst · xcodebuildmcp.com

Vexa

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

von Vexa-aiWeit verbreitet★ 2994Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · vexa.ai

Atlassian Rovo MCP Server

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

von atlassianWachsend★ 1174Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · atlassian.com

Anki MCP Server

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

von ankimcpWachsend↓ 1136/Wo.★ 567Aktualisiert letzten Monat

Läuft auf deinem Computer✓ vom Dienst · ankimcp.ai
Im Vergleich mit ähnlichen
Dieser
AImart Parquet
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiert
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen5/54/43/32/44/43/3
LizenzApache-2.0AGPL-3.0MITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo