How to Use the Alphamoon MCP in Google ADK

Q: How do I set up Alphamoon with Google ADK?

Initialize McpToolset with your Vinkius HTTP endpoint parameters. Pass this toolset to your LlmAgent constructor. The agent automatically maps the tools to Gemini functions.

Q: Can Google ADK handle long contracts from the Alphamoon MCP Server?

Yes. You pull the full text via getocrresults and feed it into Gemini. The long-context window easily fits massive legal documents.

Q: How do I filter which Alphamoon tools Google ADK sees?

Pass the toolnames argument when configuring the toolset. This restricts the agent to specific actions like listdocuments while blocking destructive tools like deletedocument.

Q: Does the MCP Server support batch invoice processing?

The listdocumentsbyprocess tool handles batch tracking. Your agent queries this endpoint to monitor the status of multiple invoices simultaneously.

Connect Alphamoon to Google ADK to extract contract data and feed it directly into BigQuery.

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 Google ADK

Create your Vinkius account to connect Alphamoon to Google ADK 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 Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Scale document extraction on Google ADK

The `upload_document` tool feeds your raw files into the OCR engine. Gemini's massive context window then ingests the resulting text via `get_ocr_results`. This setup lets you process hundred-page contracts without chunking the text. Your agent manages the workflow using `list_processes`. It polls the extraction status and triggers BigQuery inserts the moment the job finishes. Native Google Cloud integration means this pipeline runs securely within your existing infrastructure.

Pull structured fields from invoices

Fetching key-value pairs happens through `get_extraction_results`. The agent requests specific data points from processed forms, and the MCP Server delivers them as clean JSON. You bypass manual parsing entirely. Managing document schemas requires `list_templates` and `get_template`. Your Gemini agent reads the available templates to decide how to process incoming files. Filtering templates happens through the `tool_names` argument in the ADK setup.

Clean up sensitive files automatically

Removing processed files relies on the `delete_document` tool. Your agent executes this command immediately after the data hits Vertex AI. This keeps your document queues clean and prevents stale data accumulation. Checking system health takes one call to `check_alphamoon_status`. The agent verifies connectivity before starting large batch jobs. Using `McpToolset` with the HTTP transport ensures these MCP status checks resolve in milliseconds.

Setup guide

Set up Alphamoon MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Alphamoon tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Alphamoon_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Alphamoon tools via MCP.",
    tools=mcp_tools,
)

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 Google ADK

Initialize `McpToolset` with your Vinkius HTTP endpoint parameters. Pass this toolset to your `LlmAgent` constructor. The agent automatically maps the tools to Gemini functions.

Yes. You pull the full text via `get_ocr_results` and feed it into Gemini. The long-context window easily fits massive legal documents.

Pass the `tool_names` argument when configuring the toolset. This restricts the agent to specific actions like `list_documents` while blocking destructive tools like `delete_document`.

The `list_documents_by_process` tool handles batch tracking. Your agent queries this endpoint to monitor the status of multiple invoices simultaneously.

Vinkius executes the OCR tools inside a zero-trust sandbox. The memory allocation disappears the second your document extraction completes. No legal text persists on the hosting infrastructure.

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