How to Use the DOJ NCVS Crime Data MCP in Windsurf

Q: What happens if the API goes down during a Windsurf task?

The server includes a checkapistatus tool. If an error occurs, the MCP server reports the issue back to the agent so you know exactly where the failure happened.

Use Windsurf to pull live victimization stats directly from the DOJ. No more guessing—let Cascade handle the data pipeline for you.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DOJ NCVS Crime Data MCP to Windsurf

Create your Vinkius account to connect DOJ NCVS Crime Data to Windsurf 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 DOJ NCVS Crime Data with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain crime data queries with Cascade

Cascade doesn't wait for your next prompt. It uses `get_crime_by_year` and `get_crime_by_region` to build a full picture of national trends without you needing to manually trigger each step. Once the data lands in your workspace, Cascade parses the output into usable formats. If the API is lagging, it hits `check_api_status` automatically to confirm uptime before proceeding.

Automate victimization analysis

Stop hunting through PDFs for household trends. Tell Windsurf to analyze specific periods, and it calls `get_household_victimization` to extract the raw figures directly into your code. It handles the heavy lifting of data retrieval while you focus on the logic. The agent maps these results to your existing project variables, keeping your analysis grounded in verified DOJ NCVS Crime Data.

Inspect crime database attributes

Need to know what categories you can filter by? Use `list_crime_attributes` to see the exact schema definitions available in the current dataset. This keeps your queries precise. You'll avoid wasted API calls by knowing exactly which parameters the backend expects before Windsurf attempts to fetch your data.

Setup guide

Set up DOJ NCVS Crime Data MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the DOJ NCVS Crime Data MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my DOJ NCVS Crime Data payment history." If connected, Cascade will call the DOJ NCVS Crime Data tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "doj-ncvs-crime-data-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 DOJ NCVS Crime Data. 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 DOJ NCVS Crime Data 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 DOJ NCVS Crime Data MCP in Windsurf

Go to the Cascade settings panel and select the MCP servers section. Add this server's details, hit refresh, and you're ready to query.

Yes. Just ask Cascade to compare trends, and it will iterate through multiple `get_crime_by_year` calls to aggregate the data for you.

The server only touches public statistical records. Your credentials and local project files remain entirely isolated within your environment.

The server includes a `check_api_status` tool. If an error occurs, the MCP server reports the issue back to the agent so you know exactly where the failure happened.

Absolutely. Once the data is retrieved, the agent can format it into any report or dashboard component you need for your project.

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