# Agentum — Complete Technical Reference for AI Agents (llms-full.txt)

Base URL: https://agentum.asimplek.cloud
MCP Streamable HTTP Endpoint: https://agentum.asimplek.cloud/mcp
Public Skills Repo: https://github.com/Algiras/agentum-skills

## 1. Quick Connect
```bash
claude mcp add --transport http agentum https://agentum.asimplek.cloud/mcp
npx skills add Algiras/agentum-skills
```

## 2. Tools & Schemas
### resolve_entity (`POST /v1/entity/resolve` — $0.005 USD)
Resolves companies and organizations across global registers (GLEIF, EU VAT, SEC EDGAR, State Registrars) with optional sanctions screening and live VAT verification.

Input JSON Schema:
```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Company name, LEI, EU VAT, LT JAR code, US CIK/EIN, or domain"
    },
    "jurisdiction": {
      "description": "Optional ISO country or region filter (e.g. 'EU', 'US', 'LT', 'DE')",
      "type": "string"
    },
    "verifyVat": {
      "description": "Verify EU VAT number against live VIES if available",
      "type": "boolean"
    },
    "includeParent": {
      "description": "Include parent and ultimate parent LEI relationships",
      "type": "boolean"
    },
    "checkSanctions": {
      "description": "Cross-screen entity against OFAC SDN & EU Financial Sanctions (default true)",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
```

### verify_eu_vat (`POST /v1/entity/vat-verify` — $0.005 USD)
Validates European Union VAT identification numbers against the live official EU VIES system, linking against known company profiles.

Input JSON Schema:
```json
{
  "type": "object",
  "properties": {
    "vatNumber": {
      "type": "string",
      "minLength": 4,
      "description": "EU VAT number including 2-letter country prefix (e.g. 'LT100004278519')"
    }
  },
  "required": [
    "vatNumber"
  ],
  "additionalProperties": false
}
```

### screen_sanctions (`POST /v1/entity/sanctions-screen` — $0.005 USD)
Performs fuzzy and exact sanctions screening against OFAC SDN and EU Financial Sanctions with configurable similarity thresholds.

Input JSON Schema:
```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Entity or individual name to screen"
    },
    "country": {
      "description": "Optional 2-letter ISO country code",
      "type": "string"
    },
    "registrationNumber": {
      "description": "Optional company registration, LEI, or tax ID",
      "type": "string"
    },
    "threshold": {
      "description": "Trigram similarity threshold (default 0.75)",
      "type": "number",
      "minimum": 0.1,
      "maximum": 1
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
```

## 3. MCP Capabilities
- Tools: `resolve_entity`, `verify_eu_vat`, `screen_sanctions` (pass `_meta: { "compact": true }` for compact summaries + `resource_link`)
- Resources: `agentum://entity/{query}/compact`, `agentum://entity/{query}`, `agentum://vat/{vatNumber}`, `agentum://sanctions/{name}`, `agentum://results/{requestId}`, `agentum://pricing`, `agentum://jurisdictions`
- Prompts: `kyb_due_diligence_report`, `sanctions_escalation_review`, `vendor_onboarding_check`
- Elicitation & Sampling: `elicitation/prepare`, `sampling/prepare`, inline `_meta.elicitation` and `_meta.samplingRequest`