docimprint
Try live

← All docs

On this pageAgent Quickstart

Agent Quickstart

DocImprint ·

How do agents integrate with DocImprint?

Follow the Agent Quickstart at /docs/agents: get a Bearer API key, paste Claude Desktop (mcp-remote) or Cursor config for https://api.docimprint.com/mcp, call extract_text, then verify_bundle. Discovery: /.well-known/agent.json and /openapi.json.

First verified win with MCP in about five minutes: get a key, paste a host config, run one tool, verify the bundle.

1

Get an API key

MCP requires a Bearer API key. Free credits are enough for this walkthrough.

Get API keyAuth details →
2

Add DocImprint to your agent host

Replace dr_live_YOUR_KEY with your key. Claude Desktop needs the mcp-remote bridge; Cursor can use a remote URL + headers.

jsonClaude Desktop (mcp-remote)
{
  "mcpServers": {
    "docimprint": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.docimprint.com/mcp",
        "--header",
        "Authorization:${DOCIMPRINT_AUTH}"
      ],
      "env": {
        "DOCIMPRINT_AUTH": "Bearer dr_live_YOUR_KEY"
      }
    }
  }
}
jsonCursor (remote URL)
{
  "mcpServers": {
    "docimprint": {
      "url": "https://api.docimprint.com/mcp",
      "headers": {
        "Authorization": "Bearer dr_live_YOUR_KEY"
      }
    }
  }
}

Save the config, fully quit and reopen the host, then confirm a docimprint server appears with tools loaded. Endpoint: https://api.docimprint.com/mcp

3

First win — extract a document

Ask your agent to call extract_text on the sample PDF:

textPrompt to paste
Use the DocImprint extract_text tool on https://bitcoin.org/bitcoin.pdf.
Return the bundle_id and manifest_sha256 from the result.

Sample source: https://bitcoin.org/bitcoin.pdf

You should see an envelope with at least:

jsonExpected fields (shape)
{
  "bundle_id": "ev_3f8a1c2d-7e4b-4a9f-b2c1-d5e6f7a8b9c0",
  "manifest_sha256": "a3f8c2d1e4b76f9c0d2e5a8b1c4f7e2d9a6b3c8f1e4d7a0b2c5f8e1d4a7b0c3",
  "text": "…"
}
4

Verify the evidence

Prove the agent read a signed bundle — via MCP or REST. Bundle tools return a receipt field (rcpt_…); verify it with verify_action_receipt or GET /v1/extract/receipts/{id}/verify.

textMCP — verify_bundle
Use verify_bundle with bundle_id ev_3f8a1c2d-7e4b-4a9f-b2c1-d5e6f7a8b9c0
and confirm the evidence signature is valid.
bashREST — GET /v1/extract/:id/verify
# Replace bundle_id with the value from your extract response
curl https://api.docimprint.com/v1/extract/ev_3f8a1c2d-7e4b-4a9f-b2c1-d5e6f7a8b9c0/verify \
  -H "Authorization: Bearer dr_live_..."

# Quick status-only check:
# curl "https://api.docimprint.com/v1/extract/ev_3f8a1c2d-7e4b-4a9f-b2c1-d5e6f7a8b9c0/verify?quick=true" \
#   -H "Authorization: Bearer dr_live_..."
5

What's next

Full MCP tool catalog (21 tools). Protocol notes on the MCP pillar page.

Document

  • extract_textPDF or image → raw text via OCR
  • extract_tablesPDF or image → Markdown tables
  • parse_invoiceInvoice/receipt → merchant, line items, totals
  • check_claimsDocument + claims[] → supported / contradicted / not_found
  • extract_structuredDocument + JSON schema → typed fields with citations
  • summarize_documentDocument → summary + key_points[]

URL

  • extract_urlHTTPS URL → page text
  • summarize_urlHTTPS URL → summary + key_points[]
  • qa_urlHTTPS URL + question → cited answer
  • translate_urlHTTPS URL + target language → translated text

Bundle

  • verify_bundlebundle_id → integrity check (returns receipt)
  • get_bundlebundle_id → metadata + artifacts (returns receipt)
  • notarize_bundleAnchor manifest hash on Base L2 (returns receipt)
  • verify_action_receiptrcpt_… → signature + manifest binding check

Collections

  • create_collectionCreate a named document corpus
  • list_collectionsList collections you own
  • add_document_to_collectionIndex a bundle into a collection (returns receipt)
  • search_collectionSemantic search over indexed chunks
  • ask_collectionCross-document Q&A with citations

Ops

  • get_job_statusPoll async job by job_id
  • get_quotaCredits used / remaining (free)

Also MCP prompts: claim_check_workflow, invoice_intake.

Discovery (no docs required)

  • GET /Free

    Health check plus links to agent.json, OpenAPI, and SKILL.md. No auth required.

    Open live →
  • GET /.well-known/agent.jsonFree

    A2A discovery document: capabilities, auth, pricing, and endpoint URLs for agent orchestrators.

    Open live →
  • GET /.well-known/darkroom-keys.jsonFree

    Same payload as GET /v1/keys — well-known path for clients that expect /.well-known/darkroom-keys.json.

    Open live →
  • GET /openapi.jsonFree

    OpenAPI 3.1 schema for the full REST surface — use for codegen, SDKs, and HTTP agents.

    Open live →
  • GET /SKILL.mdFree

    Plain-text onboarding for LLMs: when to call which endpoint and how to pay.

    Open live →

Agent card: /.well-known/agent.json · OpenAPI: /openapi.json

Also see: MCP pillar (product / SEO) · For agents (concepts) · REST Quickstart

Related

REST Quickstart

curl extract + verify

MCP pillar

Product / SEO overview

For agents

Concepts