# Validation

1const result = await api.validate('file_read', {
2  path: '/home/user/document.txt',
3});
4
5// Response
6{
7  allowed: true,
8  decision: {
9    effect: 'ALLOW',
10    matchedRule: { id: 'allow-file-read', ... },
11    reason: 'Matched rule: allow-file-read',
12    evaluatedAt: '2024-01-15T10:30:00Z'
13  },
14  token: 'eyJhbGciOiJIUzI1NiJ9...',
15  requestId: 'req_abc123',
16  latencyMs: 12.5
17}

1const result = await api.validate('database_query', {
2  query: 'SELECT * FROM users',
3}, {
4  trustLevel: 'VERIFIED',      // UNTRUSTED | VERIFIED | TRUSTED
5  permission: 'READ',          // READ | WRITE | EXECUTE
6  includeToken: true,
7  serverName: 'my-mcp-server',
8});