How to Use the Ambee Soil MCP in Windsurf

Connect Windsurf to Ambee Soil and let Cascade build field condition maps while you get coffee.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ambee Soil MCP to Windsurf

Create your Vinkius account to connect Ambee Soil 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 Ambee Soil with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map Your Fields Autonomously

Give Cascade a high-level goal, like mapping soil moisture across your property. It takes it from there. Cascade plans the steps, calls `get_grid_soil` to pull the necessary data points, and then can even suggest the right code to visualize it as a heatmap. You don't have to prompt each step. Just state the outcome you want—a complete GIS-ready map—and Windsurf's agent figures out how to get it done using the Ambee Soil tools. It's a real time-saver.

Analyze Soil Trends with this MCP Server

Stop exporting CSVs and running manual analyses. Just ask Cascade to check for drought risk over the last 90 days. It will chain together calls to `get_historical_soil` to pull trend data and `get_soil_properties` to understand the context of your soil type. Your agent delivers a summary right in your IDE. You get the full picture of moisture, temperature, and soil composition trends without having to write the queries or connect the dots yourself.

Get Instant, Area-Wide Soil Readings

Need a quick status check on your entire farm before you irrigate? Tell Cascade to get a soil report for a specific area. It combines `get_latest_soil` for point-in-time data with `get_soil_by_radius` to cover the whole zone. This gives you a complete snapshot of current conditions across multiple points. No more checking single locations one by one. Cascade gets you the data you need to make a decision, fast.

Setup guide

Set up Ambee Soil 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 Ambee Soil 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 Ambee Soil payment history." If connected, Cascade will call the Ambee Soil tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ambee-soil-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 Ambee. 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 Ambee Soil 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 Ambee Soil MCP in Windsurf

Open the MCP Marketplace inside Windsurf and install it with one click. Cascade automatically discovers the new tools, so you can start asking it to fetch soil data right away.

Yes. Just ask Cascade, 'What are the soil properties at these coordinates?' It will use the `get_soil_properties` tool to pull the pH, organic carbon content, and other key details for that location.

Simply tell Cascade what you need, like 'Show me soil moisture trends for the past 30 days.' It will use the `get_historical_soil` tool from this MCP server to get the data and present it.

No, this MCP server is a data source. It connects Ambee's global soil data to your AI client, letting you pull that information directly into your development or analysis workflow.

No. The server only processes location coordinates, soil moisture, and temperature readings. Vinkius isolates each request in an ephemeral sandbox, and your Windsurf MCP token handles authentication without exposing your account keys.

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

Vercel AI SDK sdk-typescript