Optimus MCP
Optimus MCP connects compatible AI assistants to Optimus VAT lookup and validation. After you add the hosted MCP endpoint to your assistant, you can ask it to resolve VAT IDs, find VAT ID candidates from company data, and validate customer or supplier records.
Use MCP when you want an assistant to work with Optimus during a conversation. Use the CLI for CSV file automation, and use the Integration API when your own software sends HTTP requests directly.
Hosted Endpoints
| Environment | MCP endpoint |
|---|---|
| Production | https://mcp.app.optimussoftware.de |
| Test | https://mcp.dev.app.optimussoftware.de |
Use the test endpoint while trying a new assistant workflow. Use production only when the assistant should work with production Optimus data.
Choose The Right Integration
| Choose | Best for |
|---|---|
| Integration CLI | Scheduled CSV exports, folder automation, and systems that cannot call an API. |
| Integration API | Applications that send JSON requests directly from your own code. |
| Optimus MCP | AI assistants that should help users look up or validate VAT data interactively. |
What Your Assistant Can Do
Once connected, your assistant can help with tasks such as:
- Check whether one VAT ID is valid.
- Return normalized company and address data when Optimus can resolve it.
- Search for VAT ID candidates from a company name, country, and address.
- Validate one or more customer or supplier records.
- Continue a longer validation run and summarize the final result.
The assistant uses hosted Optimus access behind the scenes. Your users can ask normal business questions instead of preparing technical API requests.
Access And Authentication
Create a Personal Access Token in the Optimus web app under Settings > API Interface > API Tokens.
Your MCP client must send that token as a bearer token when it connects to the hosted MCP endpoint. Optimus uses the same token management as the Integration API, so token creation, revocation, allowed IP ranges, and access rules remain managed in Optimus.
What To Read Next
- Start with MCP Getting Started to connect an assistant.
- Use What Assistants Can Do for example customer prompts.
- Use Security And Troubleshooting before giving an assistant access to customer data.