Set up Windsurf

Add the Veracity Development MCP Server to Windsurf so Cascade, Windsurf's AI agent, can query official Veracity documentation and API references without leaving your editor.

An MCP server is a service that exposes tools, prompts, and resources to an agent over the Model Context Protocol. The Veracity Development MCP Server exposes six tools (covering documentation search, document retrieval, and live API exploration) that give your agent access to current official Veracity documentation and API definitions.

Before you begin

• Windsurf installed
• Network access to https://docs.veracity.com/mcp

Steps

Add the MCP server

Windsurf loads MCP server configuration from ~/.codeium/windsurf/mcp_config.json. The file follows the same JSON schema as Claude Desktop.

1. Create or open ~/.codeium/windsurf/mcp_config.json.
   • On Windows, the path is %USERPROFILE%\.codeium\windsurf\mcp_config.json.
2. Add the Veracity Docs server entry:

{
  "mcpServers": {
    "veracity-docs": {
      "url": "https://docs.veracity.com/mcp"
    }
  }
}

3. Save the file and restart Windsurf.

Add a project rules file

A .windsurfrules file gives Cascade persistent project-level instructions. Adding a Veracity entry ensures the agent queries documentation tools for Veracity-related tasks automatically.

1. Open or create .windsurfrules in your project root.
2. Add the following section:

## Veracity documentation

When working with Veracity APIs, platform features, or authentication flows, query the veracity-docs MCP server before writing or modifying code. Available tools: search_Veracity_dev_docs, get_Veracity_doc_by_path, get_Veracity_doc_range, list_Veracity_platform_apis, get_Veracity_api_methods, get_Veracity_api_method.

3. Save the file.

Enable the server in Cascade

1. Open Cascade: Ctrl+L (Windows/Linux) or Cmd+L (macOS).
2. Select the settings icon in the Cascade panel.
3. Navigate to MCP and confirm that veracity-docs appears with an active status.
4. If the server does not appear, save mcp_config.json again and restart Windsurf.

Verify the result

Ask Cascade a question that requires current Veracity documentation, such as:

• How do I add Veracity authentication to my .NET project?
• Show me the Veracity API reference for tenant management

Cascade invokes search_Veracity_dev_docs or get_Veracity_doc_by_path and applies the retrieved documentation to your question. If neither tool is invoked, confirm that mcp_config.json contains valid JSON and that the server shows as active in the Cascade MCP settings.

Troubleshooting

The server does not appear in Cascade MCP settings Confirm that mcp_config.json is in the correct location and contains valid JSON. Restart Windsurf after saving changes.

The agent answers without using the MCP tools Reference the server explicitly in your prompt: Use the veracity-docs MCP to find the current authentication guide.

The server URL is unreachable Verify network access to https://docs.veracity.com/mcp. If your organisation proxies outbound HTTPS, add the URL to your allow list.