# Scispot MCP

> Scispot MCP Server manages cannabis laboratory operations from a conversational interface. It lets your AI agent track samples, monitor instrument health, issue Certificates of Analysis (CoA), and maintain full chain-of-custody compliance using real-time lab data. You can manage everything from sample intake to final regulatory reporting without clicking through complex LIMS dashboards.

## Overview
- **Category:** data-management
- **Price:** Free
- **Tags:** lims, sample-tracking, regulatory-compliance, lab-automation, analytical-results, chain-of-custody

## Description

When you hook up your AI agent to the **Scispot MCP Server**, it takes over managing your whole cannabis lab operation. You don't have to wrestle with complex LIMS dashboards; your agent handles everything from sample receipt through final regulatory reporting using nothing but natural conversation.

**Tracking Samples and Clients.** You can pull a directory of all clients, checking their license types, seeing their testing history, and reviewing what custom panel configurations they need. When samples come in, you get a full list of submitted cannabis samples; this shows the sample type, when it arrived, its chain of custody record, and its current testing status. You can monitor client testing orders through `list_orders`, tracking them from initial submission right up to invoicing and seeing estimated completion dates. For the specific analytical methods run, you pull a catalog of available test panels—like potency or pesticides—reviewing their accreditation status and pricing tiers.

**Managing Production Runs.** You get a view of every production batch using `list_batches`, checking if they're pending or complete and linking them to specific samples. When high-throughput work happens, the agent tracks lab plates (96-well, 384-well) via `list_plates`, showing their status during whole batches of sample processing runs. You can review every executed analytical run on an instrument using `list_runs`, documenting quality control results and whether the overall disposition was accepted or rejected.

**Reviewing Results and Compliance.** You pull all detailed test findings for any sample via `list_results`. This data shows pass/fail determinations against state-specific regulatory limits, providing full chemical profiles. To confirm product compliance, you gather all issued Certificates of Analysis (CoA) using `list_certificates`; this includes potency data and the QR codes needed for consumer verification. You can also check your test scope by reviewing available analytical methods for everything from heavy metals to mycotoxins.

**Monitoring Equipment Health.** The server lets you list lab instruments—like GC-MS or HPLC systems—showing their current calibration status and when they're scheduled for maintenance. You review standardized lab processes through `list_workflows`, mapping out steps like sample intake or CoA approval so you can find process bottlenecks. For deep dives into operational oversight, you pull a complete record of all audit logs using `list_audit_logs`; this tells you exactly who did what and when, which is mandatory for regulatory audits and data integrity checks.

**Deep Dive Capabilities.** You check the full status of batches via `list_batches` to see if they're cleared for distribution, and you can also view a detailed list of all available test panels using `list_tests`. You get a complete map of standardized lab processes with `list_workflows`, identifying exactly where samples move through intake or CoA approval. Furthermore, the agent reviews every executed run on an instrument via `list_runs` to document quality control results and overall disposition (accepted or rejected).

Your AI client handles all this by reading real-time lab data, letting you manage everything from sample intake right up to final regulatory reporting without ever having to click through a confusing LIMS dashboard. You're running the whole show, not just glancing at reports.

## Tools

### list_audit_logs
Retrieves every recorded action—who did what, when, and why—for regulatory audits and data integrity checks.

### list_batches
Lists all cannabis production batches, showing their status (pending, complete) and linking them to specific samples.

### list_certificates
Gathers all issued Certificates of Analysis (CoA), including potency data and the QR codes needed for consumer verification.

### list_clients
Accesses a directory of clients, showing their license types, testing history, and custom panel configurations.

### list_instruments
Lists lab instruments (like GC-MS or HPLC), detailing their calibration status and next scheduled maintenance date.

### list_orders
Monitors client testing orders, tracking them from submission through invoicing and providing estimated completion dates.

### list_plates
Tracks high-throughput lab plates (96-well, 384-well), showing their status during batch sample processing runs.

### list_results
Pulls all detailed test findings for samples, including pass/fail determinations against regulatory limits and full chemical profiles.

### list_runs
Reviews every executed analytical run on an instrument, documenting QC results and overall disposition (accepted or rejected).

### list_samples
Lists all submitted cannabis samples, showing their type, received date, chain of custody, and current testing status.

### list_tests
Provides a catalog of available analytical test panels (potency, pesticides, etc.), along with accreditation status and pricing tiers.

### list_workflows
Maps out standardized lab processes, identifying steps like sample intake or CoA approval to find bottlenecks in the process.

## Prompt Examples

**Prompt:** 
```
Show me all cannabis samples currently in testing and their expected completion dates.
```

**Response:** 
```
Scanning active laboratory queue via Scispot... I found 31 samples currently in testing across your analytical departments. Breakdown: 12 samples in Potency (HPLC) — average completion 2025-04-12, 8 samples in Terpene Profiling (GC-MS) — expected 2025-04-13, 6 samples in Pesticide Screening (LC-MS/MS) — due 2025-04-14, and 5 samples in Heavy Metals (ICP-MS) — targeting 2025-04-15. Four samples are marked as priority rush orders with 24-hour turnaround commitments. Would you like the detailed chain of custody and testing status for any specific client submissions?
```

**Prompt:** 
```
List all pending Certificates of Analysis awaiting quality manager review and authorized signatory approval.
```

**Response:** 
```
Reviewing CoA approval queue in Scispot... I found 9 Certificates of Analysis pending quality manager review and authorized signatory approval. Notable entries: CoA-2025-1047 (Blue Dream Batch BD-5521 — potency 29.1% THC, full contaminant panel clearance), CoA-2025-1048 (OG Kush Batch OG-4492 — terpene profile verified, pesticides non-detect), and CoA-2025-1051 (Sour Diesel Concentrate SD-C903 — residual solvents within state limits, mycotoxins passed). Average pending review time is 16 hours. Three are rush orders requiring release within 24 hours. Should I prioritize these for immediate signatory review?
```

**Prompt:** 
```
Check the integration status with Metrc seed-to-sale tracking and automatic CoA publishing to state regulatory systems.
```

**Response:** 
```
Querying Scispot integration health dashboard... All external platform connections are operational and compliant. Metrc seed-to-sale synchronization: last successful transmission 2025-04-09 15:47 UTC (189 CoAs published automatically, 0 submission failures, 3 pending retries for network timeouts). State regulatory API compliance: all mandatory test result submissions current through Q1 2025 reporting period. Automated CoA consumer portal (WeedMaps integration): 17 new certificates pushed in last 24 hours, all QR verification codes confirmed active and scannable. GLUE instrument data ingestion: 5 HPLC systems and 3 GC-MS instruments transmitting raw chromatograms successfully. No integration errors or data sync failures detected in past 14 days. Would you like me to generate a comprehensive integration performance summary for your records?
```

## Capabilities

### Track Sample Status
The agent manages the entire lifecycle of a cannabis sample, noting its chain of custody and current testing stage.

### Issue Compliance Reports
Retrieve Certificates of Analysis (CoAs) that confirm product compliance against state-specific regulatory limits.

### Monitor Lab Equipment Health
Verify the calibration status and maintenance schedules for major instruments like GC-MS or HPLC systems.

### Review Production Batches
Get a complete view of production batches, linking them to samples and determining if they are cleared for distribution.

### Audit Operational Records
Generate detailed operational logs necessary for regulatory compliance checks (e.g., FDA 21 CFR Part 11).

## Use Cases

### Handling an Urgent Recall Inquiry
A client calls needing to know the status of a recalled batch. Instead of manually checking multiple systems, your agent runs `list_batches` and cross-references the results using `list_results`. You get instant confirmation on which specific lot IDs are cleared for distribution.

### Preparing for an Inspection Audit
An auditor asks about sample handling protocols. Your agent pulls data from `list_audit_logs` to show the exact timestamp and user who processed critical steps, proving adherence to ISO/IEC 17025 standards with zero manual effort.

### Determining Sample Priority
A rush sample comes in. Your agent checks `list_samples` for the current queue status and then uses `list_tests` to verify if the necessary test panel (e.g., specific pesticide screening) is accredited and available, allowing you to set accurate client expectations.

### Troubleshooting Lab Downtime
The GC-MS unit fails mid-day. Your agent checks `list_runs` for the last successful run parameters and then consults `list_instruments` to see if the machine's maintenance records are up to date, speeding up technician diagnosis.

## Benefits

- Verify Instrument Readiness: Check `list_instruments` to confirm calibration dates and maintenance schedules for your HPLC or GC-MS systems before assigning any tests. You never want a run failing due to equipment issues.
- Instant Compliance Checks: Need to know if Batch BD-5521 is good to ship? Use `list_certificates` to pull the latest CoA, checking THC/CBD percentages and contaminant clearance in one query.
- Full Accountability Trail: Regulatory inspectors want proof. Running `list_audit_logs` gives you an immutable record of every change made, satisfying FDA 21 CFR Part 11 requirements instantly.
- Process Bottleneck Detection: Use `list_workflows` to identify where the lab process slows down—is it sample intake or CoA review? This helps you reallocate staff and improve throughput.
- Streamlined Client Management: Quickly check client status using `list_clients`. You can verify if a facility is active, what licenses they hold, or what custom test panels they require.

## How It Works

The bottom line is that your AI agent speaks directly to the lab data, giving you instant answers without needing to log into any dashboard.

1. Subscribe to the Scispot server and generate your API key in the Vinkius dashboard.
2. Provide the generated API key to your AI client (e.g., Claude or Cursor) for connection.
3. Ask your agent specific questions, like 'Show me all pending CoAs' or 'What is the status of sample ABC-123?'

## Frequently Asked Questions

**How do I use list_certificates with Scispot MCP Server?**
The agent retrieves all CoAs by linking them to a specific batch or sample ID. You can ask it to filter for only those pending review, which is useful before filing regulatory reports.

**Can I check instrument status using list_instruments?**
Yes. The agent pulls the model number, serial number, and current calibration date for every piece of equipment. This helps you schedule maintenance or halt testing on faulty gear.

**Does list_audit_logs track everything I do?**
It tracks critical actions: who modified a result, when the CoA was issued, and any change to user permissions. It’s your primary tool for demonstrating data integrity during audits.

**How does list_samples help with my workflow?**
You can use it to see the entire queue: which samples arrived today, what they are being tested for, and their estimated completion date. It helps you manage client expectations immediately.

**How can I use list_orders to monitor overall laboratory capacity?**
The tool lists current order status and estimated completion dates. It shows you the workload by identifying pending orders versus those already invoiced, helping manage your lab's available throughput.

**When should I use list_workflows to improve our standard testing procedures?**
You use this tool to map out or audit your standardized processes. It details assigned roles, required quality checkpoints, and helps pinpoint operational bottlenecks in your lab's routine.

**If a result is incomplete, how do I check its status using list_results?**
You can filter results by the approval or review status. This shows you exactly which findings need sign-off from quality assurance or require further investigation before they are released.

**What compliance details does list_batches provide for regulatory reporting?**
It gives the batch's final disposition, including whether it is released, quarantined, rejected, or destroyed. This provides critical state-to-sale identifiers needed for mandatory regulatory reporting.

**Can my AI automatically verify if a cannabis sample has passed all required tests and is ready for Certificate of Analysis issuance?**
Yes! Use the `list_results` tool to fetch all completed analytical findings for a specific sample. Your AI agent will respond with comprehensive pass/fail determinations across potency, terpenes, pesticides, heavy metals, mycotoxins, and microbial panels. Once all state-mandated tests show passing results, use `list_certificates` to verify CoA generation status and confirm automatic Metrc submission. Always verify regulatory limit compliance before releasing products to distribution or retail channels.

**How do I quickly identify which laboratory instruments are approaching calibration expiry or require preventive maintenance?**
Simply ask the agent to run the `list_instruments` action. It will compile all analytical equipment tracked via Scispot GLUE integration with calibration status, last service date, next scheduled maintenance, IQ/OQ/PQ qualification records, and current operational state. The AI will proactively highlight any HPLC, GC-MS, ICP-MS, or other systems approaching calibration expiry or overdue for preventive maintenance. This ensures your laboratory maintains ISO/IEC 17025 compliance, analytical data integrity, and inspection readiness at all times.

**Does the Scispot integration allow modifying test results, deleting samples, or revoking issued Certificates of Analysis?**
No. The current toolset focuses strictly on read-only querying and analytical operations — listing samples, reviewing results, checking certificates, monitoring workflows, and tracking instrument health. State alteration operations (modifying test data, deleting samples, revoking certificates, or changing approvals) are not currently exposed. This design assures your laboratory records remain secure against destructive queries, maintains complete audit trail integrity for regulatory inspections, and preserves data immutability required by FDA 21 CFR Part 11 and ISO/IEC 17025 standards.