# Datascope — how to use (mcp.ai)

Connect your Datascope account and use 19 tools for forms and surveys straight from your AI agent. Connect with your own API key. DataScope is the ideal tool to get rid of paperwork, save time and collect data efficiently from the field. The platform allows your team to answer personalized mobile forms (even offline), from their phones or tablets.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_datascope?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `datascope_change_form_answer`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/datascope`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/datascope/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/datascope/change/form/answer` — Tool to change a specific answer in a submitted form. Use when you need to modify question values after a form has been submitted.
  - body: { form_code: string, form_name: string, question_name: string, subform_index?: integer, question_value: string }
- `POST https://api.mcp.ai/api/datascope/create/list` — Tool to create a new empty list (metadata type) in DataScope with specified list_type. Use when you need to create a container for list elements like products, locations, or other categorized items.
  - body: { list: object }
- `POST https://api.mcp.ai/api/datascope/create/list/element` — Tool to create a new list element in a specific metadata list identified by metadata_type. Use when you need to add a new element to a list. For location objects, use the locations API instead.
  - body: { list_object: object, metadata_type: string }
- `POST https://api.mcp.ai/api/datascope/create/location` — Tool to create a new location in DataScope with geographic coordinates. Use when you need to register a physical location with name and code identifiers.
  - body: { location: object }
- `POST https://api.mcp.ai/api/datascope/create/task/assign` — Tool to create a task assignment for a specific form, user, and location with a deadline. Use when you need to assign a form to be completed by a specific user at a specific location and time.
  - body: { gap?: integer, code?: string, date: string, c_code?: string, c_name?: string, l_code: string, form_id: integer, l_email?: string, l_phone?: string, user_id: string, latitude?: string, longitude?: string, location_name?: string, location_address?: string, task_instruction?: string }
- `POST https://api.mcp.ai/api/datascope/get/all/list/elements` — Tool to retrieve all items from a specific metadata list in Datascope. Use when you need to fetch all elements belonging to a particular list type (products, locations, customers, etc.).
  - body: { metadata_type: string }
- `POST https://api.mcp.ai/api/datascope/get/all/locations` — Tool to retrieve all locations configured in the DataScope system. Use when you need to access location data including addresses, coordinates, and company associations.
- `POST https://api.mcp.ai/api/datascope/get/answers/v4` — Tool to retrieve form answers using the v4 API endpoint. Use when you need to fetch form submissions from DataScope with the latest API version. Supports filtering by user, date range, location, and p
  - body: { end?: string, limit?: integer, start?: string, offset?: integer, form_id: integer, user_id?: integer, location_id?: integer, date_modified?: boolean }
- `POST https://api.mcp.ai/api/datascope/get/answers/with/full/metadata` — Tool to retrieve last form answers with full metadata from DataScope (limit 600 results). Returns detailed response structure including answers array with question types, metadata references, and assi
  - body: { end?: string, start?: string, form_id?: integer, user_id?: string, location_id?: integer }
- `POST https://api.mcp.ai/api/datascope/get/form/schema` — Tool to retrieve the schema definition for a specific form by its form ID. Use when you need to understand the structure of a form including all questions, field types, and configurations.
  - body: { form_id: string }
- `POST https://api.mcp.ai/api/datascope/get/forms/list` — Tool to retrieve all available forms/tasks from the DataScope system. Use when you need to get a list of forms that can be assigned or filled out.
- `POST https://api.mcp.ai/api/datascope/get/last/tickets` — Tool to retrieve the last 5 tickets (findings) from the DataScope system. Use when you need to view recent tickets or findings.
- `POST https://api.mcp.ai/api/datascope/get/list/element` — Tool to retrieve a specific element from a metadata list by type and ID. Use when you need to fetch detailed information about a specific list element such as locations, products, or other metadata ob
  - body: { metadata_id: integer, metadata_type: string }
- `POST https://api.mcp.ai/api/datascope/get/ticket/types` — Tool to retrieve available ticket types (findings types) from the DataScope system. Use when you need to access the list of ticket type configurations.
- `POST https://api.mcp.ai/api/datascope/list/last/generated/files` — Tool to retrieve all generated files (PDFs, Excel) from a specific date range. Use when you need to access recently generated files within the last 90 days. Date format is MM/DD/YYYY.
  - body: { end?: string, start?: string }
- `POST https://api.mcp.ai/api/datascope/list/notifications` — Tool to retrieve all notifications (PDF and Excel files) from a date range. Use when you need to access notification details including type, URL, form information, and timestamps.
  - body: { end?: string, start?: string }
- `POST https://api.mcp.ai/api/datascope/update/bulk/list/elements` — Tool to bulk update metadata list objects with soft deletion of objects not in the incoming list. Use when you need to replace all objects in a metadata list. WARNING: This operation deletes all exist
  - body: { name: string, list_objects: object[], metadata_type: string }
- `POST https://api.mcp.ai/api/datascope/update/list/element` — Tool to update an existing list element by ID with new name, description, code, or attributes. Use when you need to modify properties of a specific metadata object in DataScope.
  - body: { id: integer, list_object: object }
- `POST https://api.mcp.ai/api/datascope/update/location` — Tool to update an existing location in DataScope by ID. Use when you need to modify location details such as name, address, coordinates, or company information.
  - body: { id: integer, location: object }

## Example prompts
- "What can I do in Datascope?"
- "Show me a summary of my Datascope account"

## More
- Page: https://mcp.ai/datascope
- Agent spec (llms.txt): https://mcp.ai/datascope/llms.txt
- Postman collection: https://mcp.ai/datascope/postman.json