Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

AImart Parquet

de balogvnversión 0.1.3i★ 0iComputadora o nubeRepositorio ↗
Nombre en el registroio.github.balogvn/aimart-parquet

Cómo instalar

What it does

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

  • Connects Computadora o nube
  • Account or key No key needed
  • Category Documentos, hojas de cálculo y oficina

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

MinerU

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

de opendatalab★ 83.9191 skills

Skill · Guía de trabajoSin licencia indicada

watermarks-remover

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

de guillaumemeyer★ 27.7231 skills

Skill · Guía de trabajo

obsidian-skills

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

de kepano★ 53.104 (whole repo)5 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala AImart Parquet. Sigue https://mcp.popnx.com/i/balogvn-aimart-parquet.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (balogvn--aimart-parquet.us-east.modal.run) · ✓ Comandos revisados el 18 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreAImart Parquet
    Remote MCP server URL · Direcciónhttps://balogvn--aimart-parquet.us-east.modal.run/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsAImart Parquet

  4. Pruébalo

    Usa AImart Parquet y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando AImart Parquet o muestra una herramienta de AImart Parquet en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreAImart Parquet
    Connection · Direcciónhttps://balogvn--aimart-parquet.us-east.modal.run/mcp
  3. Elige AImart Parquet en un chat

    Abre un chat nuevo y elige AImart Parquet en tus plugins antes de escribir

  4. Pruébalo

    Usa AImart Parquet y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando AImart Parquet o muestra una herramienta de AImart Parquet en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

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

    Deberías ver AImart Parquet en la lista como conectado

  4. Pruébalo

    Usa AImart Parquet y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando AImart Parquet o muestra una herramienta de AImart Parquet en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa AImart Parquet y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando AImart Parquet o muestra una herramienta de AImart Parquet en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa AImart Parquet y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando AImart Parquet o muestra una herramienta de AImart Parquet en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://balogvn--aimart-parquet.us-east.modal.run/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa AImart Parquet💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
    }
  }
}

Instalado en tu computadora

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Licenciai
Apache-2.0
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.3
Publicado en el registroi
18 nov 2026
Último cambio de códigoi
18 nov 2026
Última revisión
17 nov 2026
Creador
balogvn
Paquetes
pypi: aimart-parquet
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 17 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub balogvn, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • ✓ Superada

    El endpoint responde

    Respondió en 280 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 6 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Documentos, hojas de cálculo y oficinai

  • Más estrellas que el 0% de los otros 4126 servidores de esta categoría
  • Publicado en el registro más recientemente que el 93% de los otros 4126 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 4126 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro AImart Parquet?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (0.1.3) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Puter MCP

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

de HeyPuterMuy usado★ 44,2 milActualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · puter.com

XcodeBuildMCP

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

de getsentryMuy usado↓ 130,5 mil/sem paquete compartido★ 6,6 milActualizado hace 4 meses

Se ejecuta en tu computadora✓ del servicio · xcodebuildmcp.com

Vexa

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

de Vexa-aiMuy usado★ 3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · vexa.ai

Atlassian Rovo MCP Server

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

de atlassianEn crecimiento★ 1,2 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · atlassian.com

Anki MCP Server

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

de ankimcpEn crecimiento↓ 1,1 mil/sem★ 567Actualizado el mes pasado

Se ejecuta en tu computadora✓ del servicio · ankimcp.ai
Comparado con otros parecidos
Este
AImart Parquet
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipo
Necesita claveNoNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoSíNo
Revisiones básicas5/54/43/32/44/43/3
LicenciaApache-2.0AGPL-3.0MITApache-2.0Apache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo