How to Use the Bidsketch MCP in Mastra AI

Q: How does Mastra AI handle errors when calling Bidsketch tools?

The framework uses automatic exponential backoff. If listproposals or other tools experience temporary rate limits, Mastra retries the execution automatically before failing.

Q: Can I run Mastra AI workflow steps in parallel?

Yes, you can trigger listclients and listtemplates simultaneously to gather all necessary context before initiating a proposal draft.

Build resilient, multi-step proposal workflows using Mastra AI and Bidsketch.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bidsketch MCP to Mastra AI

Create your Vinkius account to connect Bidsketch 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 Bidsketch with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated proposal generation with Mastra AI

The `create_proposal` tool allows Mastra workflows to generate client-ready estimates programmatically. By combining this tool with Mastra's branching logic, your agent can automatically draft a proposal when a CRM trigger fires. If the creation step fails due to API limits, Mastra's built-in retry engine backs off and tries again. This keeps your sales pipeline moving without manual intervention.

Dynamic client matching via MCP Server

The `list_clients` tool lets your agent query your entire customer directory to locate matching records. Mastra workflows use this data to decide whether to create a new record or attach a proposal to an existing account. When no match is found, the workflow routes to `create_client` to register the prospect. This conditional execution prevents messy duplicate records in your sales platform.

Automated contract tracking and follow-ups

The `get_proposal_details` tool retrieves the exact status, value, and view history of any active estimate. Your Mastra agents run this tool on a cron schedule to identify proposals that have been viewed but not signed. Once identified, the workflow triggers a follow-up email sequence or alerts your sales team. This automated tracking ensures hot leads never go cold.

Setup guide

Set up Bidsketch 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 Bidsketch 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: "bidsketch-alternative-mcp-client",
  servers: {
    "bidsketch-alternative-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Bidsketch 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 Bidsketch. 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 Bidsketch 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 Bidsketch MCP in Mastra AI

Instantiate the MCP client in your Mastra config using your Vinkius endpoint URL. Spread the output of `listTools()` directly into your Agent's tool array to make them available.

Yes, Mastra supports human-in-the-loop approvals. You can configure your workflow to pause and ask for confirmation before the agent calls `create_proposal` with your raw client data.

The framework uses automatic exponential backoff. If `list_proposals` or other tools experience temporary rate limits, Mastra retries the execution automatically before failing.

Yes, you can trigger `list_clients` and `list_templates` simultaneously to gather all necessary context before initiating a proposal draft.

Every connection uses zero-trust architecture with a single endpoint token. Vinkius runs this MCP Server inside isolated, ephemeral V8 sandboxes, meaning your contract terms, client names, and pricing structures stay encrypted and secure.

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