How to Use the Alphamoon MCP in Windsurf

Q: Can I manage my Alphamoon documents directly from Windsurf?

Yes. You can tell Windsurf to listdocuments or even deletedocument by its ID. Because Cascade can plan multi-step actions, you could ask it to "find all documents from last month and delete the ones marked 'test'."

Give Windsurf a goal, and its Cascade agent uses Alphamoon to extract data from invoices, contracts, and forms—no manual steps required.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alphamoon MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Document Workflows

Tell Windsurf to process a new batch of invoices. Its Cascade agent gets to work, using Alphamoon's `upload_document` tool for each file and then running `get_ocr_results` to read the contents. Without any more prompting, Cascade continues the job. It calls `get_extraction_results` to pull out structured data like invoice numbers and totals. It can even finish by calling `list_documents_by_process` to confirm everything ran correctly, giving you a final summary.

Find Any Document, Instantly

You don't need to memorize tool names. Just ask Windsurf a question in plain English, like, "Find the details for document ID 12345." It knows to use the `get_document` tool to fetch exactly what you need. This works for lists, too. Ask, "Show me all documents in the 'Q3 Invoices' process," and Windsurf uses `list_documents_by_process` to get the answer. It's much faster than clicking through a web interface.

Inspect Your Alphamoon MCP Server

Windsurf can also help you understand and debug your setup. Ask it to check on your Alphamoon configuration by saying, "List all available templates." It will run the `list_templates` tool and show you the results right in your IDE. This is great for troubleshooting. If a document fails to process, you can ask Windsurf to `get_process` or `get_template` to see the exact configuration that was used. It's like having an expert on your Alphamoon setup ready to answer questions.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "alphamoon-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 Alphamoon. 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 Alphamoon 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 Alphamoon MCP in Windsurf

You give Windsurf a high-level goal, like "Process the invoices in this folder." Its Cascade agent automatically chains Alphamoon tools: it uploads each file with `upload_document`, runs `get_ocr_results`, and then pulls structured data using `get_extraction_results`.

Yes. You can tell Windsurf to `list_documents` or even `delete_document` by its ID. Because Cascade can plan multi-step actions, you could ask it to "find all documents from last month and delete the ones marked 'test'."

The easiest way is through the built-in MCP Marketplace in Windsurf. Just find Alphamoon and click to install. You can also add it manually by editing your `mcp_config.json` file if you prefer.

Absolutely. Your connection to the Alphamoon MCP Server is authenticated with a single Vinkius endpoint token. Windsurf handles the secure connection, so your credentials are never exposed in your prompts.

The server only processes the document content you explicitly provide via `upload_document`. Vinkius runs each server in an ephemeral, zero-trust sandbox, so your document data is only used for the extraction task and isn't stored long-term.

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