# Proofetch Mcp

> Verified extraction: source-backed JSON from PDFs/URLs; honest null + signed receipt.

- **Type:** MCP server
- **Install:** `agentstack add mcp-vektoris-ai-proofetch-mcp`
- **Verified:** Pending review
- **Seller:** [Vektoris-AI](https://agentstack.voostack.com/s/vektoris-ai)
- **Installs:** 0
- **Latest version:** 0.0.2
- **License:** MIT
- **Upstream author:** [Vektoris-AI](https://github.com/Vektoris-AI)
- **Source:** https://github.com/Vektoris-AI/proofetch-mcp
- **Website:** https://vektoris.de/proofetch

## Install

```sh
agentstack add mcp-vektoris-ai-proofetch-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# proofetch — verified extraction with proof per field

**Structured data from PDFs and web pages, where every value is backed by an exact source quote — or honestly left `null`. Never guessed.** Each result ships with a cryptographically signed receipt you can verify yourself.

proofetch is a hosted **MCP server** and **HTTP API** built for developers and AI agents. You pay only for fields that pass the proof — €0.02 per verified field. Empty or unprovable fields cost nothing.

- 🔗 **Landing page & pricing:** https://vektoris.de/proofetch
- 🤖 **MCP endpoint (remote):** `https://proofetch-vektoris-ai-workflows.vercel.app/mcp`
- 🧾 **Listed in the official MCP registry:** `io.github.Vektoris-AI/proofetch`

> This repository is the public connector & documentation for the hosted proofetch service. The extraction pipeline itself is operated as a service — you don't self-host it, you call it with an API key.

---

## Why proofetch

Normal extraction fills every field — even when the value is invented. You then have to re-check every number by hand. proofetch is different:

- **Never guesses.** Unsure? The field is `null` + flagged, instead of a fabricated value.
- **Provenance per field.** Every value comes with the exact source quote, verifiable against the original document.
- **Signed receipt.** The result is sealed in a signed receipt (Ed25519) — you, or an escrow, verify it without having to trust us.
- **Pay for truth only.** Billing is per field that passes the proof (`verdict: PASS`).

## Get an API key

Buy prepaid balance (from €5) on the landing page — you get your key instantly after payment:

👉 **https://vektoris.de/proofetch#preise**

## Quickstart — HTTP API

```bash
curl -X POST https://proofetch-vektoris-ai-workflows.vercel.app/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "type": "pdf_url", "value": "https://example.com/invoice.pdf" },
    "targetSchema": {
      "type": "object",
      "properties": {
        "invoice_total": { "type": "string" },
        "due_date":      { "type": "string" },
        "invoice_number":{ "type": "string" }
      },
      "additionalProperties": false
    }
  }'
```

**Source types** (`source.type`): `pdf_url`, `pdf_base64`, `url`, `text`, `html`.
**`targetSchema`** is a standard JSON Schema (`type: "object"`, `properties`, `additionalProperties: false`).

### What you get back

```jsonc
{
  "data": {
    "invoice_total": "1,190.00 EUR",
    "due_date": "2024-09-30",
    "invoice_number": null          // honest null — not found in source
  },
  "fields": [
    { "path": "invoice_total", "value": "1,190.00 EUR", "verdict": "PASS",
      "provenance": { "quote": "1,190.00 EUR", "start": 43, "end": 55 } },
    { "path": "invoice_number", "value": null, "verdict": "FAIL", "provenance": null }
  ],
  "verdict": "PARTIAL",
  "receipt": { "v": 1, "jobId": "pf_…", "outputHash": "sha256:…" },
  "billing": { "charged": true, "amountCents": 4 }
}
```

- `data` — clean JSON, each field proven or honestly `null`
- `fields[]` — per field: source quote (`provenance`) + `verdict` (`PASS`/`FAIL`)
- `verdict` — overall: `PASS`, `PARTIAL`, or `FAIL`
- `receipt` — signed proof with hashes, self-verifiable

Check your balance any time: `GET /billing/balance` with the same key.

## Use as an MCP server (remote)

proofetch speaks the Model Context Protocol over Streamable HTTP. Point any MCP-capable client at the remote endpoint with your key as a bearer token.

**Endpoint:** `https://proofetch-vektoris-ai-workflows.vercel.app/mcp`
**Auth:** `Authorization: Bearer YOUR_API_KEY`
**Tool:** `verified_extract` — same contract as the HTTP API above.

Example client config (generic MCP `streamable-http` remote):

```json
{
  "mcpServers": {
    "proofetch": {
      "type": "streamable-http",
      "url": "https://proofetch-vektoris-ai-workflows.vercel.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

## Open standards

proofetch is built for autonomous agents: discoverable via the **A2A** card and **MCP**, payable per call via **x402 / AP2**, and every receipt is independently verifiable.

## Links

- Landing page & pricing — https://vektoris.de/proofetch
- Official MCP registry — https://registry.modelcontextprotocol.io/?search=proofetch
- Operated by **Vektoris** — https://vektoris.de

---

© Vektoris. The proofetch service and pipeline are proprietary; this connector/documentation is provided under the MIT License (see `LICENSE`).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Vektoris-AI](https://github.com/Vektoris-AI)
- **Source:** [Vektoris-AI/proofetch-mcp](https://github.com/Vektoris-AI/proofetch-mcp)
- **License:** MIT
- **Homepage:** https://vektoris.de/proofetch

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **0.0.2** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-vektoris-ai-proofetch-mcp
- Seller: https://agentstack.voostack.com/s/vektoris-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.