# DataScope MCP MCP > DataScope connects your mobile form data collection to any AI client. It lets you manage field inspections, audits, and site assessments using natural conversation. You can list available forms, retrieve specific submissions with metadata, or even get secure PDF download URLs for auditing. This MCP handles all the messy backend work of field operations so your agent acts as your dedicated data coordinator. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** mobile-forms, field-inspections, data-collection, offline-sync, audit-management, digitization ## Description Take full control of your mobile form data collection without ever touching a dashboard. Your AI client connects to this MCP and lets you manage field operations through natural conversation. Forget manually downloading CSV files or digging through thousands of scattered responses in the portal. You can programmatically list submissions, filtering by forms, users, or date ranges; you can also access detailed metadata for every single submission record. Need a report? Your agent handles it, retrieving secure PDF download URLs directly into your chat window. Furthermore, you can oversee team collaboration by listing all registered organization users and even checking tracked locations. Connecting this MCP via Vinkius means your AI becomes the central hub for all things field data. ## Tools ### get_submission_pdf_url Generates a secure URL that allows downloading the professional PDF report for a single submission. ### get_submissions_with_metadata Lists multiple form submissions and includes detailed metadata about each entry, like question types. ### list_form_submissions Lists completed form submissions, giving you the option to filter by specific forms or users. ### list_available_forms Retrieves a list of all template forms that can be used for data collection. ### list_tracked_locations Pulls historical data points on where field inspections took place. ### list_organization_users Provides a complete directory listing of all registered personnel within the organization. ## Prompt Examples **Prompt:** ``` List the last 5 form submissions for form ID '1024'. ``` **Response:** ``` I've retrieved the latest submissions for form 1024. Highlights include 3 'Maintenance Checks' and 2 'Site Audits'. Would you like the detailed answers for the most recent entry? ``` **Prompt:** ``` Show me all registered users in my DataScope organization. ``` **Response:** ``` I've retrieved your user directory. You currently have 10 active field members, including @user1 and @user2. Shall I check who submitted the most forms today? ``` **Prompt:** ``` Get the PDF download link for submission ID 'ans_789'. ``` **Response:** ``` Link generated! You can download the professional PDF report for submission ans_789 here: [download_url]. The link is secure and ready for distribution. ``` ## Capabilities ### List available forms See a directory of every form template used by the organization. ### Retrieve specific submissions Fetch records of completed inspections, allowing filtering by form ID or user who submitted it. ### Get full submission metadata Access detailed information about a batch of submissions, including question types and internal identifiers for analysis. ### Download PDF reports Generate secure, professional PDF report links for any specific form submission. ### List organization users Get a complete directory of every registered user within the company structure. ### Check field locations Pull historical data on tracked locations and collection points for operational transparency. ## Use Cases ### Auditing a specific site visit A manager needs to check the compliance of all safety checks done last quarter. They ask their agent to use `list_form_submissions` for a date range, and then request the detailed PDF report using `get_submission_pdf_url` for the worst-performing record. ### Onboarding new field staff An HR officer needs to confirm who is eligible to submit forms. They ask their agent to use `list_organization_users`, getting a full roster so they can grant access rights efficiently. ### Analyzing form usage trends A data analyst wants to know which types of inspection are most common. The agent uses `list_available_forms` first, then runs `get_submissions_with_metadata` on a sample set to understand the full range of collected data. ### Investigating process gaps A site supervisor suspects field teams are skipping mandatory checks. The agent uses `list_tracked_locations` and cross-references it with submission records from `list_form_submissions`, identifying geographical areas with missing data. ## Benefits - Stop manually downloading files. Instead of exporting CSVs, your agent can use `list_form_submissions` to pull filtered lists directly into a chat window, giving you instant visibility. - Improve reporting speed by using the `get_submission_pdf_url` tool. You get secure PDF links for audits immediately, without navigating through multiple download pages. - Coordinate data analysis with `get_submissions_with_metadata`. This lets your agent see not just the answers, but also the underlying structure of the forms, which is critical for complex reporting. - Oversee team compliance by using `list_organization_users` and `list_available_forms`. You maintain a real-time directory of who's active and what forms they can access. - Maintain high operational transparency by querying `list_tracked_locations`. Your agent accesses historical location points, letting you trace exactly where inspections happened. ## How It Works The bottom line is you manage field data using conversational prompts instead of clicking through complex web interfaces. 1. Subscribe to the DataScope MCP, then grab your API Key from the DataScope dashboard. 2. Connect your AI client (like Cursor or Claude) using that API key. The agent now has access to all form and user data. 3. Ask your agent a question—for example, 'Show me all submissions for Form ID 1024'—and it retrieves the answers instantly. ## Frequently Asked Questions **How does the DataScope MCP handle user permissions?** It lists all registered organization users using `list_organization_users`. This tool gives you a directory of who is in the system, helping you understand your team's scope. **What if I need more detail than just the list of submissions?** Use `get_submissions_with_metadata`. It goes beyond simple listing by providing rich metadata for each submission record, which is essential for deep analysis. **Can I get a clean PDF report from DataScope MCP?** Yes. The tool `get_submission_pdf_url` generates a secure download link for the professional PDF version of any given submission, perfect for official records. **How do I find out what forms are even available?** You can run `list_available_forms`. This tool gives you a complete directory of every form template that the organization has set up for data collection. **How do I find out about locations using the `list_tracked_locations` tool?** The tool provides a list of all recorded field data collection points. You can use this to map operational transparency and verify if specific areas have been checked by your team. **How do I filter form submissions using the `list_form_submissions` tool?** You can specify filters for both Form IDs and User IDs. This lets you quickly narrow down thousands of responses to only those submitted by a particular person or related to a specific inspection type. **What details does `list_organization_users` provide about my field team?** This tool returns the complete directory of registered organization users. You can confirm who is active in the system and manage your list of authorized data collectors before an audit. **If I use `get_submissions_with_metadata`, what kind of data fields are available for analysis?** It gives you rich metadata, including question types and internal identifiers. This allows data analysts to structure the raw field submissions for complex reporting or database ingestion. **How do I find my DataScope API Key?** Log in to the DataScope Web Portal, navigate to **Settings** > **Integrations**, and copy your unique API Key. **Can I filter submissions by specific users?** Yes! The `list_form_submissions` tool allows you to provide a `user_id` to retrieve only the answers submitted by a particular team member. **How do I get the PDF report for a submission?** Use the `get_submission_pdf_url` tool with a submission ID to generate a temporary download link for the professional PDF report.