Aucterra MCP Server

This repository configures an MCP-compatible server for Aucterra's Document Understanding APIs using the aucterra-mcp package.

It enables LLM agents to interact with Aucterra's document classification, extraction, etc. services using Google's Agent Development Kit (ADK).

🔧 Configuration

Include this block in your mcpServers configuration (e.g., config.json or mcp.yaml):

{ "mcpServers": { "aucterra": { "command": "pipx", "args": [ "run", "--spec", "git+https://github.com/japisuru/aucterra-mcp", "aucterra-mcp" ], "env": { "AUCTERRA_API_KEY": "your_api_key_here" } } } }

🔐 Required Environment Variables

Variable	Description
`AUCTERRA_API_KEY`	Your API key for accessing Aucterra's services

Related MCP server: MCP LLMS-TXT Documentation Server

⚙️ Tool Behavior

This MCP tool provides structured access to Aucterra's:

📁 Document Classification
🗂️ Key-Value Field Extraction (Simple + List fields)

The tool accepts pdf or image files and returns structured JSON output.

✅ Agent Integration (Google ADK)

To use this tool within your LlmAgent, configure it as follows:

from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset, StdioServerParameters aucterra_tool = MCPToolset( connection_params=StdioServerParameters( command="pipx", args=[ "run", "--spec", "git+https://github.com/japisuru/aucterra-mcp", "aucterra-mcp" ], env={"AUCTERRA_API_KEY": "your_api_key_here"} ) )

Add this tool to your agent via tools=[aucterra_tool].

📚 Example Use Cases

User: Classify this document (/path/to/the/document/doc.pdf) into invoice or identity document. User: Extract the following fields: NIC, Full Name, Date of Birth from this document (/path/to/the/document/doc.pdf) User: Extract Tax ID as 'Tax Identification Number' from this document (/path/to/the/document/doc.pdf).

The agent will use the Aucterra MCP server to extract fields, filling in missing values (e.g., using the same value for field_key and field_name if only one is provided).