How to Use the Aracaju MCP in Windsurf

Q: Can I use Windsurf to track specific Aracaju contracts?

Yes. You can ask Windsurf to find bids with listbids and then monitor the associated agreements using listcontracts. Since Windsurf's Cascade agent can chain commands, you can set a goal like 'Find all contracts awarded to Company X' and it will figure out the steps.

Ask Windsurf to analyze Aracaju's budget, and it just does it. No more manual API calls from a government portal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aracaju MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Budget Tracking

Tell Windsurf: 'Compare Aracaju's revenues and expenses for last quarter.' Cascade kicks in. It plans the steps, calls `list_revenues` and `list_expenses` for you, and presents the data. You don't have to prompt it twice. This isn't just about getting data. It's about getting answers. Windsurf chains the tools together, so you can ask complex questions about city finances without knowing the specific tool names. It figures it out.

Follow the Money in Public Contracts

Check public contracts right from your editor. Start with a simple prompt: 'Find the latest construction bids in Aracaju.' Windsurf's Cascade will run `list_bids`, then you can follow up by asking it to find the associated contracts using `list_contracts` once they're awarded. Because Cascade can chain actions, you can build a whole narrative. 'Show me bids from Company X, then list all contracts they've won.' Windsurf executes that entire sequence for you, no hand-holding required.

Audit Payroll with this MCP Server

This Aracaju MCP Server connects public payroll data directly to your agent. Ask Windsurf, 'List the highest-paid city positions.' It calls `list_personnel` and gives you the answer. No need to browse a government website or parse a PDF. The real power is combining tools. You could have Windsurf check if a contractor listed in `list_contracts` also appears on the city payroll via `list_personnel`. It's a simple prompt for you, but a powerful, multi-step operation for the agent.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "aracaju-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 Aracaju Transparency. 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 Aracaju 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 Aracaju MCP in Windsurf

You can add it one-click from Windsurf's built-in MCP Marketplace. Alternatively, add the server URL to your `mcp_config.json` file. Once connected, Cascade automatically discovers all the Aracaju tools.

Yes. You can ask Windsurf to find bids with `list_bids` and then monitor the associated agreements using `list_contracts`. Since Windsurf's Cascade agent can chain commands, you can set a goal like 'Find all contracts awarded to Company X' and it will figure out the steps.

This server gives you structured JSON data directly. You don't have to build or maintain a scraper that will break when the city's website changes. Windsurf gets clean data every time.

No. That's the point of Windsurf's Cascade agent. You state your goal in plain English, like 'Find new public works projects,' and Cascade determines which tools to call in what order.

This server only accesses public records from Aracaju's transparency portal. Your connection is secured by Vinkius, but the data itself—bids, contracts, expenses, personnel lists, and revenues—is already public information. We don't see or store your queries.

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