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 |
⚙️ 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).
📦 Dependencies
Ensure pipx is installed and available on your system.
Install it via:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
🛠️ Issues
If you encounter issues, ensure your API key is correct and the tool is up to date:
pipx upgrade aucterra-mcp