How to Use the Sproof MCP in Mastra AI

Q: How does Sproof and mastra-ai handle document listing?

You list documents using listdocuments when your workflow needs to pull an inventory. This tool reports all existing files managed by Sproof. It's designed for batch processing, making it ideal for background jobs that need many inputs.

Q: What data does Sproof and mastra-ai use to track history?

For tracking, you rely on listaudittrail. This tool retrieves the full history of a signing request, showing every action taken over time. It's essential for compliance reporting. It provides a clear, uneditable log that confirms when and by whom actions were executed.

Q: Can Sproof and mastra-ai manage signers?

Yes. The listsigners tool retrieves all individuals assigned to a specific signing request. This lets your workflow know exactly who needs to act. You can also use getsignaturerequest to see the full context of the required roles.

Q: How do I ensure data integrity with Sproof and mastra-ai?

You should always verify workflow state using getsignaturerequest. This function confirms that the request is in a stable, expected status. If you need to start over, remember the cancelsignaturerequest tool exists for clean termination.

Q: What data type does Sproof and mastra-ai touch regarding privacy?

This server touches Signature Request metadata. The entire structure of a signing session, including its status and assigned signers, is managed through this MCP Server.

Build complex, failure-proof enterprise workflows and sign documents using mastra-ai's automated retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Sproof MCP to Mastra AI

Create your Vinkius account to connect Sproof to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Sproof with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Execute Multi-step Workflows

The `create_signature_request` tool lets your agent initiate a complex signing workflow, passing all necessary data in one go. This is perfect for background jobs that require multiple steps to complete. If the process hits a snag—say, an API timeout—the framework handles automatic retries with exponential backoff, so you don't have to write that retry logic yourself.

Monitor Workflow State

To check if a workflow is still running or failed, use `get_signature_request`. This gives the current status of the entire signing session. You can also list all sessions with `list_signature_requests` to get an overall view. This robust monitoring means your CLI script always knows whether it needs to wait, retry, or report a failure.

Manage Signers and Contacts

You can manage the people involved by listing all signers using `list_signers` for any given request. Before that, make sure your system has the correct contact details; use `create_contact` or `list_contacts`. The `get_profile` tool is handy here because it lets you confirm the identity of the user running the workflow.

Setup guide

Set up Sproof MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Sproof tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "sproof-mcp-client",
  servers: {
    "sproof-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Sproof Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Sproof tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Sproof transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Sproof. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Sproof now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Sproof MCP in Mastra AI

You list documents using `list_documents` when your workflow needs to pull an inventory. This tool reports all existing files managed by Sproof. It's designed for batch processing, making it ideal for background jobs that need many inputs.

For tracking, you rely on `list_audit_trail`. This tool retrieves the full history of a signing request, showing every action taken over time. It's essential for compliance reporting. It provides a clear, uneditable log that confirms when and by whom actions were executed.

Yes. The `list_signers` tool retrieves all individuals assigned to a specific signing request. This lets your workflow know exactly who needs to act. You can also use `get_signature_request` to see the full context of the required roles.

You should always verify workflow state using `get_signature_request`. This function confirms that the request is in a stable, expected status. If you need to start over, remember the `cancel_signature_request` tool exists for clean termination.

This server touches **Signature Request** metadata. The entire structure of a signing session, including its status and assigned signers, is managed through this MCP Server.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript