# Beagle Security MCP > Beagle Security automates penetration testing right inside your agent workflow. List projects, kick off tests for any application, and pull detailed vulnerability reports without touching a dashboard. Your AI client handles the whole security audit process. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** penetration-testing, web-security, automated-testing, vulnerability-assessment, security-audit ## Description Forget manually jumping between dashboards just to check on test progress or grab findings. This MCP connects automated security checks directly into your natural conversation flow. You tell your agent what you need—like checking the status of an ongoing assessment, listing all target applications, or retrieving a full list of vulnerabilities found—and it handles the API calls behind the scenes. This means security testing becomes part of your coding process, not a separate chore. Whether you're managing multiple projects or just need to verify compliance reports, you get the data instantly, right where you work. When you connect this MCP through Vinkius, you give any compatible AI client immediate access to advanced tooling, making complex security workflows feel like simple chat commands. ## Tools ### get_application_details Gets specific details about a registered application within Beagle Security. ### get_project_details Retrieves comprehensive information for a single security project. ### get_test_results Pulls the final, detailed results from a completed security test run. ### get_test_status Checks and reports the current status of an ongoing or past security assessment. ### get_user_profile Retrieves your personal Beagle account profile data. ### get_vulnerabilities Lists all identified vulnerabilities found within a specific test run. ### list_applications Provides a comprehensive list of all managed security applications. ### list_projects Generates a list of every security project currently defined in the account. ### start_test Initiates and begins a new automated security test for your chosen application or project. ### stop_test Stops an active, ongoing security assessment before it finishes. ## Prompt Examples **Prompt:** ``` List all my current security projects on Beagle. ``` **Response:** ``` I've retrieved your projects. You currently have 3 projects: 'E-commerce API' (ID: proj_123), 'Mobile Backend' (ID: proj_456), and 'Admin Dashboard' (ID: proj_789). Which one would you like to inspect? ``` **Prompt:** ``` Start a new security test for application token app_998877. ``` **Response:** ``` Triggering the security test... Done! Test ID 'test_554433' has been started for your application. You can check its status using `get_test_status`. ``` **Prompt:** ``` Show me the findings from the last test test_554433. ``` **Response:** ``` Retrieving results for test_554433... I found 3 vulnerabilities: 1 Critical (SQL Injection), 1 High (XSS), and 1 Medium (Missing Security Headers). Would you like the full details for the SQL Injection? ``` ## Capabilities ### List and manage projects You can list all available security projects or retrieve detailed information about a specific target application. ### Start and stop tests Trigger new security assessments instantly, or halt an active test if necessary. ### Check assessment status Get real-time updates on any running security test to see its current progress. ### Retrieve findings and vulnerabilities Pull detailed reports, including lists of all found vulnerabilities or the complete results from a completed test. ## Use Cases ### A developer needs quick security signoff before merging code. The agent checks: 'Can you check the status of the payment module test?' The system runs `get_test_status`. If it's done, the agent then uses `get_vulnerabilities` to report back: 'I found 2 critical flaws: one in XSS and one missing header.' No manual dashboard checks needed. ### A security engineer needs a full scope of all targets for compliance. The agent first runs `list_applications` to map out everything. Then, it uses `get_project_details` sequentially across multiple projects, compiling a single master list of every audited asset in the chat. ### A devops team needs to stop an expensive, runaway test. The agent detects unusual activity and runs `stop_test`. The system confirms the interruption. This saves compute resources and keeps the workflow clean. ### An architect wants to compare two different services for security gaps. The agent first uses `list_applications` to identify both targets, then runs `start_test` on each one. Finally, it runs `get_test_results` on both sets of results to give the architect a side-by-side comparison. ## Benefits - Instead of navigating multiple project dashboards, you simply ask your agent to list projects or get details for a target application. This saves clicks and time. - You can kick off new security tests instantly using the `start_test` tool. Just tell your agent which app needs checking, and it starts the process. - Need to know if the test is done? Use `get_test_status` to check real-time progress without refreshing a web page. It’s immediate feedback. - Once testing is complete, you pull all the hard data using `get_test_results`. You get structured lists of vulnerabilities and findings right in your chat window. - The MCP lets you automate compliance work by calling tools like `list_applications` and gathering historical records for auditing purposes. - You can even halt a test mid-run using the `stop_test` tool if something goes wrong, giving you granular control over the assessment process. ## How It Works The bottom line is that you just talk to your AI client; it handles all the project setup and data retrieval using Beagle Security's tools. 1. Subscribe to this MCP and provide your Personal Access Token and Application Token. 2. Connect your agent via any compatible client (Claude, Cursor, etc.). 3. Ask your agent a question like 'Show me the vulnerabilities for Project X,' and it runs the necessary checks. ## Frequently Asked Questions **How do I list all my security projects using Beagle Security MCP?** You simply ask your agent to run the `list_projects` tool. It will instantly retrieve and show you every project defined in your account, so you don't need to log into the dashboard. **What is the difference between `get_test_results` and `get_vulnerabilities` with Beagle Security MCP?** `get_test_results` provides the overall, comprehensive outcome of a test. Use `get_vulnerabilities` when you only want a focused list detailing specific flaws found during that assessment. **Can I start multiple tests at once with Beagle Security MCP?** Yes, you can guide your agent to use the `start_test` tool multiple times in succession for different applications or projects within a single chat thread. **Do I need special permissions for the Beagle Security MCP?** Yes. When setting up this MCP, you must provide both your Personal Access Token and Application Token to grant your agent the necessary rights to run tests. **How do I check if a test is still running with Beagle Security MCP?** Run the `get_test_status` tool. It provides real-time information on whether the assessment is queued, in progress, or finished, saving you from guessing. **Is there a way to stop a test if it fails? (Beagle Security MCP)** Absolutely. If an ongoing scan goes wrong or hits rate limits, the agent can execute `stop_test` immediately, saving time and resources.