MCP Primitives

@Tool({
  name: 'create_user',
  title: 'Create User Account',
  description: 'Create a new user account with email and profile information',
  inputSchema: z.object({
    email: z.string().email().describe('User email address'),
    name: z.string().min(2).describe('Full name'),
    role: z.enum(['user', 'admin']).optional().describe('User role')
  }),
  outputSchema: z.object({
    id: z.string(),
    email: z.string(),
    name: z.string()
  }),
  annotations: {
    destructiveHint: false,
    idempotentHint: false,
    readOnlyHint: false,
    openWorldHint: false
  },
  examples: {
    request: { email: 'user@example.com', name: 'Jane Doe' },
    response: { id: 'usr_123', email: 'user@example.com', name: 'Jane Doe' }
  }
})
async createUser(input: CreateUserInput, ctx: ExecutionContext) {
  return this.userService.create(input);
}

@Resource({
  uri: 'user://{userId}/profile',
  name: 'User Profile',
  title: 'User Profile Details',
  description: 'Complete user profile with preferences and settings',
  mimeType: 'application/json',
  annotations: {
    audience: ['user', 'assistant'],
    priority: 0.8,
    lastModified: '2024-01-15T10:30:00Z'
  }
})
async getUserProfile(uri: string, ctx: ExecutionContext) {
  const userId = uri.match(/user:\/\/([^\/]+)/)?.[1];
  const profile = await this.userService.getProfile(userId);
  return {
    contents: [{
      uri,
      mimeType: 'application/json',
      text: JSON.stringify(profile, null, 2)
    }]
  };
}

@Prompt({
  name: 'code_review',
  title: 'Code Review Assistant',
  description: 'Generate a code review request with best practices checklist',
  arguments: [
    { name: 'language', description: 'Programming language', required: true },
    { name: 'focus', description: 'Review focus areas', required: false }
  ]
})
async getCodeReviewPrompt(args: { language: string; focus?: string }, ctx: ExecutionContext) {
  return [{
    role: 'user' as const,
    content: `Review this ${args.language} code focusing on: ${args.focus || 'general best practices'}`
  }];
}

import { InitialTool, ToolDecorator as Tool, ExecutionContext } from '@nitrostack/core';

@InitialTool()

import { Controller, ToolDecorator as Tool, InitialTool, ExecutionContext, z } from '@nitrostack/core';

@Controller('system')
export class SystemController {
  @Tool({
    name: 'bootstrap_session',
    description: 'Initializes the client session and returns server capabilities',
    inputSchema: z.object({}),
  })
  @InitialTool()
  async bootstrapSession(input: Record<string, never>, ctx: ExecutionContext) {
    ctx.logger.info('Session established', { sessionId: ctx.sessionId });

    return {
      serverName: 'Enterprise Order Management',
      version: '1.2.0',
      authenticatedSubject: ctx.auth?.subject ?? 'anonymous',
      capabilities: ['orders_create', 'orders_get_status'],
    };
  }
}