What Assistants Can Do
Optimus MCP gives your assistant a small set of VAT lookup and validation actions. In normal use, your users should ask business questions and let the assistant handle the Optimus call.
Available Actions
| Customer goal | What the assistant does | Action name shown by some MCP clients |
|---|---|---|
| Check one VAT ID | Resolves the VAT ID and reports whether it is valid. | resolve_vat |
| Find a VAT ID from company data | Searches for VAT ID candidates using company name, country, and address. | lookup_vat |
| Validate customer or supplier records | Runs Optimus validation for one or more records and summarizes the result. | validate_vat_records |
| Continue a longer validation | Checks progress and retrieves the final result when processing is complete. | get_vat_validation_result |
Check One VAT ID
Use this when the VAT ID is already known.
Options:
| Customer choice | What to provide | Option name shown by some MCP clients |
|---|---|---|
| VAT ID to check | The VAT ID, preferably with country prefix, for example DE284700631. | vat_id |
| Transliteration | Ask Optimus to transliterate resolved company and address fields, or leave this unset to use your Optimus user settings. | transliterate |
| Additional address components | Ask Optimus to include the street name and house number as separate fields when available. Supported values are addressStreetName and addressHouseNumber. | include |
Example prompt:
Use Optimus MCP to check whether DE284700631 is valid and show the resolved company data.
Example with an option:
Use Optimus MCP to check whether DE284700631 is valid. Use transliteration for the resolved company and address data.
Use Optimus MCP to check whether DE284700631 is valid and include street name and house number separately if available.
Expected result:
- VAT status, such as valid, invalid, or unavailable.
- Resolved company name when available.
- Resolved address when available.
- Time when the check was performed.
Find VAT ID Candidates
Use this when the company data is known but the VAT ID is missing or uncertain.
Options:
| Customer choice | What to provide | Option name shown by some MCP clients |
|---|---|---|
| Company name | Company name to search for. Required. | companyName |
| Country | Two-letter country code such as DE, AT, or NL. Required. | countryCode |
| Street | Street address when available. | street |
| City | City when available. | city |
| ZIP or postal code | Postal code when available. | zip |
| Unstructured address | Full address text when you do not have separate street, ZIP, and city fields. | rawAddress |
| Transliteration | Ask Optimus to transliterate resolved company and address fields, or leave this unset to use your Optimus user settings. | transliterate |
Example prompt:
Use Optimus MCP to find VAT ID candidates for Optimus Software GmbH in Germany at Tal 44, 80331 Munchen.
Example with options:
Use Optimus MCP to find VAT ID candidates for Optimus Software GmbH. Use country code DE, address Tal 44, 80331 Munchen, and transliteration.
Expected result:
- Number of matching candidates.
- Candidate VAT IDs.
- Verification status for each candidate.
- Similarity score and resolved company data when available.
Address details improve matching. Include company name and country at minimum.
Validate Records
Use this when you want Optimus to validate submitted customer or supplier records.
Record fields:
| Customer choice | What to provide | Field name shown by some MCP clients |
|---|---|---|
| VAT ID | VAT ID for the customer or supplier. | vatId |
| Company name | Company name to compare with the authoritative result. | companyName |
| Street | Street to compare with the authoritative result. | street |
| ZIP or postal code | Postal code to compare with the authoritative result. | zip |
| City | City to compare with the authoritative result. | city |
| Your own reference fields | Any value you need to map the result back to your system, such as supplier number, customer number, or import row ID. | custom fields |
Validation options:
| Customer choice | What it controls | Option name shown by some MCP clients |
|---|---|---|
| Standard or qualified validation | Use standard validation for normal checks. Use qualified validation when Optimus should verify VAT ID, company name, and address according to qualified confirmation rules. | checkType |
| Retry window | How long Optimus may retry transient validation issues. Values include no retry, 1 hour, 2 hours, 4 hours, 8 hours, and 24 hours. | retryDuration |
| Notification email | Whether the validation workflow may send its configured notification email. | sendNotificationEmail |
| Snapshot | Whether Optimus stores a snapshot of the completed result. | createSnapshot |
| PDF report | Whether to create a PDF report. | pdf.create |
| Signed PDF | Whether the generated PDF should be signed. Requires PDF creation. | pdf.sign |
| Email PDF | Whether the PDF should be sent by email through the validation workflow. Requires PDF creation. | pdf.sendByEmail |
| Return PDF as download link | Whether the result should include a PDF download URL. Requires PDF creation. | pdf.returnAsUrl |
| Return PDF as base64 | Whether the result should include the PDF content as base64. Requires PDF creation. | pdf.returnAsBase64 |
| Caller VAT ID | VAT ID to use as your own VAT identifier during validation. If omitted, Optimus uses your configured default. | ownVatId |
| Transliteration | Override transliteration for the validation, or leave this unset to use your Optimus user settings. | transliterate |
| Additional address components | Include street name and house number as separate fields in completed validation records when available. Supported values are addressStreetName and addressHouseNumber. | include |
| Processing preference | Let Optimus choose automatically, wait for the result, or start a background validation. | processing_mode |
| Retry reference | Stable reference used to avoid duplicate work if the same validation is retried. | idempotency_key |
Example prompt for one record:
Use Optimus MCP to validate this supplier record with standard validation:
VAT ID DE284700631
Company Optimus Software GmbH
Street Tal 44
ZIP 80331
City Munchen
Reference C-1001
Example with validation options:
Use Optimus MCP to validate this supplier record with qualified validation. Create a PDF report, return a download link, store a snapshot, use transliteration, and use supplier-check-2026-05-22-001 as the retry reference.
Use Optimus MCP to validate this supplier record and include street name and house number separately in the completed result.
Example prompt for a longer task:
Use Optimus MCP to validate these supplier records. Use standard validation, keep my reference IDs in the summary, and continue until the final result is available.
Expected result:
- Overall validation status.
- Per-record VAT result.
- Field comparison statuses for company and address data when available.
- Corrected or normalized data when Optimus can provide it.
- PDF report metadata when PDF creation is part of the validation options.
Longer Validations
Some validations finish immediately. Larger or longer-running validations may continue in the background.
When that happens, your assistant should continue the validation for you. Users should not need to copy operation IDs manually inside the same conversation.
Continuation options:
| Customer choice | What to provide | Option name shown by some MCP clients |
|---|---|---|
| Validation reference | The operation or validation reference returned when the validation started. | operation_id |
| Retry reference | The retry reference used when the validation was started. Use this if the validation reference is not available. | idempotency_key |
Example prompt:
Continue the Optimus validation you started earlier and summarize the final result.
Example with a retry reference:
Continue the Optimus validation for retry reference supplier-check-2026-05-22-001 and summarize the final result.
Tips For Better Results
- Provide the country together with company data when searching for VAT IDs.
- Include street, ZIP, and city when available.
- Include your own reference ID when you need to map results back to your system.
- Tell the assistant whether you want standard or qualified validation.
- Ask for a short business summary when you do not need every result detail.
When To Use The Integration API Instead
Use the Integration API instead of MCP when your application must control the full technical integration in code, including retries, response handling, and storage.