• PENDING
  • RUNNING
  • SUCCESS
  • HUMAN

How to manage asynchronous document jobs with your AI

Connect DocRaptor to your agent to offload heavy PDF and HTML rendering. Your AI manages the queue and watches for completion so you don't have to.

Ask AI about this page

Short answer

How can my AI handle long-running document tasks?

Your AI triggers the generation and then periodically checks the status until the file is ready. This keeps your chat session active while the heavy rendering happens in the background. You'll see exactly when a job finishes or fails.

Job outcomes

Where your document tasks land.

The AI routes every request based on the current state of the generation job.

PENDING

Job started

The AI kicks off the request. You'll know the moment the rendering process enters the queue.

RUNNING

Active processing

The AI monitors the progress. It keeps track of the job while the document is being built.

SUCCESS

File ready

The AI confirms the job is done. You get a notification that the document is available.

HUMAN

Error handling

If a job fails, the AI reports the issue. You'll need to step in to fix the input or retry.

The workflow

What your AI does when a document request arrives.

The AI handles the polling and status checks so you can focus on other work.

  1. Start the job

    Your AI sends the HTML or CSS data to DocRaptor to begin the render.

    create_document

  2. Check status

    The AI checks the current state of the job to see if it's still processing.

    get_document_status

  3. Track progress

    The AI continues to poll the service until the document reaches a final state.

    get_document_status

  4. Confirm completion

    The AI verifies the final status and tells you if the file is ready for use.

    get_document_status

Try it

Copy these to start.

Use these prompts to begin your first document job.

Starting points

Replace the bracketed text with your actual HTML or CSS code.

DocRaptor Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_vDbOvmZVHUH41RF0iFLoLXNwrKJcpkFRea6HC5GB/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — DocRaptor capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "docraptor-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_vDbOvmZVHUH41RF0iFLoLXNwrKJcpkFRea6HC5GB/mcp"
    }
  }
}
Copy into chat04

  • Create a PDF from this HTML: [paste HTML here]

  • Start a document job using this CSS: [paste CSS here]

  • Check the status of my last document job.

  • Generate a document from this URL: [paste URL here]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect DocRaptor once, then ask.

Link your account once. Your credentials stay encrypted, and you can immediately start managing jobs through your agent.

Connect DocRaptor to your AI

FAQ

How this task behaves.

  • 01

    Does the AI wait for the document to finish?

    It depends on your prompt. You can tell it to start the job and move on, or tell it to wait until the status shows as completed.

  • 02

    Can the AI edit the PDF content?

    No. The AI can only trigger the creation or check the status. To change content, you must ask it to create a new document.

  • 03

    What happens if the job fails?

    The AI will report the error status to you. It won't automatically retry the job unless you specifically ask it to.

  • 04

    Can the AI delete documents?

    No. There are no tools available to delete documents once they are created.

  • 05

    Can I track multiple jobs at once?

    Yes. You can trigger several jobs and ask the AI to check the status of each one.

  • More questions about DocRaptor? The Connector page answers them. See everything the DocRaptor Connector can do

Connect DocRaptor to Claude, Cursor, ChatGPT & more