How to Use the CompanyCam MCP in Mastra AI

Q: How do I require human approval before creating a CompanyCam project in Mastra AI?

You can configure your Mastra AI agent with the requireToolApproval option. When the agent attempts to run createproject, the workflow halts until an administrator approves the action in your system.

Build resilient, multi-step construction workflows with Mastra AI and live CompanyCam project data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CompanyCam MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Multi-Step Audits with Mastra AI

The `list_project_photos` tool pulls all images from a specific jobsite for automated inspection. Mastra AI drives this workflow, letting you write conditional logic that triggers if a project lacks recent photo updates. If the tool returns an empty list, Mastra's workflow engine can automatically escalate the issue. It can query `list_users` to find the project manager and queue a notification to their device.

Smart Project Creation via MCP Server

The `search_projects` tool checks your current directory before creating new files. Mastra AI executes this search as a pre-flight check, branching the workflow to either retrieve the existing project or build a new one. When a new site is required, the `create_project` tool runs with automated retries. If the CompanyCam API rate-limits the request, Mastra backs off exponentially and retries without failing the entire workflow.

Automated User Activity Logging

The `get_current_user` tool identifies which team member is executing actions through the agent. Mastra AI uses this MCP context to log audit trails, ensuring every automated action maps back to a licensed human operator. You can combine this with `list_projects` to build reports on which managers own the most active sites. The workflow engine handles the data transformation, leaving your core agent clean and focused.

Setup guide

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

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

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

Instantiate the MCP client with your Vinkius URL, then call `mcpClient.listTools()`. You can spread these tools directly into your Mastra agent configuration block to give them instant access.

Yes, Mastra has a built-in workflow engine that supports automatic retries with exponential backoff. If `list_all_photos` hits an API limit, the workflow pauses and retries the request safely.

You can configure your Mastra AI agent with the `requireToolApproval` option. When the agent attempts to run `create_project`, the workflow halts until an administrator approves the action in your system.

Absolutely. You can write workflows that fetch documents using `list_project_documents`, inspect the file count, and branch to different notification paths based on whether safety permits are present.

Yes, your project files and jobsite documentation are never stored by the integration layer. Vinkius processes your tool calls in zero-trust, ephemeral V8 isolates, acting as a secure MCP bridge between Mastra AI and the CompanyCam API.

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