How to Use the Beagle Security MCP in Claude

Q: How do I connect Beagle Security to Claude Desktop?

Open your claudedesktopconfig.json file. Add the Vinkius endpoint URL to the mcpServers block. Restart the app and the hammer icon will show your new tools.

Run penetration tests and pull vulnerability reports straight into Claude Desktop without switching tabs.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Beagle Security MCP to Claude Desktop

Create your Vinkius account to connect Beagle Security to Claude Desktop 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 Beagle Security with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Kick off security tests from Claude Desktop

Trigger a new security scan using `start_test` the moment you push a major update. You don't need to open the web dashboard or fiddle with API keys. Claude connects to your Beagle account, identifies the target application via `list_applications`, and initiates the scan immediately. Checking on that scan takes seconds instead of minutes. Ask your agent to run `get_test_status` and it returns the exact progress percentage and current testing phase. If something goes wrong or you need to halt the scan, `stop_test` kills the process right from your chat window.

Review vulnerabilities as they appear

Pull the actual security findings into your conversation with `get_vulnerabilities` to analyze them instantly. The MCP Server fetches the exact CVEs, severity levels, and endpoint details from your recent scans. You read the raw data right alongside your existing architecture notes. Grabbing the full report is just as direct. Your AI client calls `get_test_results` and formats the output into a readable summary. This lets you ask follow-up questions about specific SQL injection or cross-site scripting risks without downloading a massive PDF.

Map your entire security posture

Audit your configured environments by running `list_projects` to see every active deployment under your watch. The MCP Server maps out your infrastructure, matching project IDs to their respective domains. You get a clear view of what you are actually defending. Drill down into specific targets using `get_project_details` and `get_application_details`. These tools return the exact configuration state of your web apps and APIs. When you combine this with `get_user_profile`, you know exactly which team member owns which security project.

Setup guide

Set up Beagle Security MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Beagle Security MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Beagle Security MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under beagle-security-mcp.

json

{
  "mcpServers": {
    "beagle-security-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Beagle Security. 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 Beagle Security 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 Beagle Security MCP in Claude Desktop

Open your `claude_desktop_config.json` file. Add the Vinkius endpoint URL to the `mcpServers` block. Restart the app and the hammer icon will show your new tools.

Only when you tell it to. You ask the agent to run a scan, and it executes the command on your behalf. It never triggers a penetration test without your explicit prompt.

Yes. Go to Settings, click Integrations, and add a custom connector. Paste your MCP Server URL there to access your vulnerability data from any machine.

You might have asked for a project ID that doesn't exist. Tell your agent to list your applications first to grab the correct ID, then check the status again.

Vinkius isolates your session in a V8 sandbox that destroys itself after execution. Your raw CVEs, application tokens, and penetration test results pass directly from the API to your chat interface. We store absolutely nothing on disk.

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