@Tool

import { Tool, ToolContext } from '@frontmcp/sdk';
import { z } from '@frontmcp/sdk';

@Tool({
  name: 'get_weather',
  description: 'Get current weather for a location',
  inputSchema: {
    city: z.string().describe('City name'),
    units: z.enum(['celsius', 'fahrenheit']).default('celsius'),
  },
})
class GetWeatherTool extends ToolContext {
  async execute(input: { city: string; units: 'celsius' | 'fahrenheit' }) {
    const weather = await fetchWeather(input.city, input.units);
    return { temperature: weather.temp, conditions: weather.conditions };
  }
}

// outputSchema provided → execute()'s return type is checked against it
function Tool<I extends ZodRawShape, O>(
  opts: ToolMetadataOptions<I, O> & { outputSchema: O },
): <C>(cls: C) => C; // rewrapped with inferred ToolContext<…, In, Out>

// outputSchema omitted → execute() may return anything
function Tool<I extends ZodRawShape>(
  opts: ToolMetadataOptions<I, any> & { outputSchema?: never },
): <C>(cls: C) => C;

// Compile error: parameter type { query: number } doesn't match inputSchema { query: string }
@Tool({ name: 'search', inputSchema: { query: z.string() } })
class BadTool extends ToolContext {
  async execute(input: { query: number }) { // TS error on this class
    return { result: input.query };
  }
}

// Object output
@Tool({
  name: 'create_user',
  inputSchema: { name: z.string(), email: z.string().email() },
  outputSchema: z.object({
    id: z.string(),
    name: z.string(),
    email: z.string(),
  }),
})

// Primitive outputs: 'string', 'number', 'boolean', 'date'
@Tool({
  name: 'calculate',
  inputSchema: { expression: z.string() },
  outputSchema: 'number', // Returns a number
})

@Tool({
  name: 'greet',
  inputSchema: { name: z.string() },
  outputSchema: 'string', // Returns plain text, not { value: ... }
})

// MCP content types
@Tool({
  name: 'generate_image',
  inputSchema: { prompt: z.string() },
  outputSchema: 'image', // Returns base64 image
})

@Tool({
  name: 'text_to_speech',
  inputSchema: { text: z.string() },
  outputSchema: 'audio', // Returns base64 audio
})

@Tool({
  name: 'fetch_document',
  inputSchema: { uri: z.string() },
  outputSchema: 'resource', // Returns MCP resource
})

@Tool({
  name: 'link_document',
  inputSchema: { uri: z.string() },
  outputSchema: 'resource_link', // Returns a link to an MCP resource
})

@Tool({
  name: 'sensitive_operation',
  inputSchema: { data: z.string() },
  authProviders: [
    { name: 'github', scopes: ['repo', 'user'] }, // required by default
  ],
})
class SensitiveTool extends ToolContext {
  async execute(input) {
    // The credential gate runs before execute(): a required provider with no
    // connected credential aborts the call with a JSON-RPC -32001 error
    // (data: { tool, providers, authUrl }) — execute() never runs in that case.
    // `scopes` are advertised via the server's PRM `scopes_supported`.
    const userId = this.auth.user.sub;
    const token = this.context.authInfo?.token; // raw bearer for outbound calls
    return await callApi(token, input.data, userId);
  }
}

@Tool({
  name: 'delete_file',
  inputSchema: { path: z.string() },
  annotations: {
    readOnlyHint: false,
    destructiveHint: true,
    idempotentHint: false,
    openWorldHint: false,
  },
})

@Tool({
  name: 'search_users',
  inputSchema: { query: z.string(), limit: z.number().optional() },
  examples: [
    {
      description: 'Search for users named "john"',
      input: { query: 'john', limit: 10 },
      output: { users: [{ id: '1', name: 'John Doe' }], total: 1 },
    },
  ],
})

@Tool({
  name: 'user_profile',
  inputSchema: { userId: z.string() },
  ui: {
    template: { file: fileURLToPath(new URL('./user-profile.widget.tsx', import.meta.url)) },
  },
})

ui: {
  template: (ctx: TemplateContext<In, Out>) => ctx.helpers.html`<div>User ${ctx.input.userId}</div>`,
}

import { tool } from '@frontmcp/sdk';
import { z } from '@frontmcp/sdk';

const getWeather = tool({
  name: 'get_weather',
  description: 'Get current weather',
  inputSchema: { city: z.string() },
})((input, ctx) => {
  // ctx provides access to context methods
  const config = ctx.get(ConfigToken);
  return { temperature: 72, city: input.city };
});

async execute(input) {
  const service = this.get(ServiceToken);      // Required dependency
  const optional = this.tryGet(OptionalToken); // Optional dependency
}

async execute(input) {
  // Log message (MCP 2025-11-25 spec)
  await this.notify('Processing started', 'info');

  // Progress notification
  await this.progress(50, 100, 'Halfway done...');
}

async execute(input) {
  const result = await this.elicit(
    'Please confirm this action',
    z.object({ confirmed: z.boolean() }),
    { mode: 'form', ttl: 300000 }
  );

  if (result.status === 'accept' && result.content.confirmed) {
    // Proceed with action
  }
}

async execute(input) {
  // Detect AI platform
  if (this.platform === 'claude') {
    // Claude-specific formatting
  }

  // Get client info
  const client = this.clientInfo; // { name: 'claude', version: '1.0' }
}

import { UnauthorizedError } from '@frontmcp/sdk';

async execute(input) {
  // Rich, typed identity (preferred)
  const userId = this.auth.user.sub;          // subject (e.g. JWT `sub`)
  const email = this.auth.user.email;
  const tenantId = this.auth.claims['tenantId']; // raw JWT claim
  if (!this.auth.hasRole('admin')) {
    // Use the SDK error flow, not `throw new Error(...)` — a raw Error is
    // redacted to "Internal error" before it reaches the client, whereas a
    // PublicMcpError's message is surfaced. `this.fail` never returns.
    this.fail(new UnauthorizedError('Admin role required'));
  }
}

async execute(input) {
  // Context-aware fetch with auto-injected headers
  const response = await this.fetch('https://api.example.com/data', {
    method: 'POST',
    body: JSON.stringify(input),
  });
}

import { InvalidInputError } from '@frontmcp/sdk';

async execute(input) {
  if (!input.valid) {
    this.fail(new InvalidInputError('Invalid input'));
  }

  // Early return with output
  if (cached) {
    this.respond(cached); // Ends execution
  }
}

import { ToolInputOf, ToolOutputOf } from '@frontmcp/sdk';

const metadata = {
  name: 'my_tool',
  inputSchema: { x: z.number(), y: z.number() },
  outputSchema: z.object({ result: z.number() }),
} as const;

type Input = ToolInputOf<typeof metadata>;   // { x: number; y: number }
type Output = ToolOutputOf<typeof metadata>; // { result: number }

import { Tool, ToolContext, App, FrontMcp, InvalidInputError } from '@frontmcp/sdk';
import { z } from '@frontmcp/sdk';

const inputSchema = {
  operation: z.enum(['add', 'subtract', 'multiply', 'divide']),
  a: z.number(),
  b: z.number(),
};

const outputSchema = z.object({
  result: z.number(),
  operation: z.string(),
});

@Tool({
  name: 'calculate',
  description: 'Perform arithmetic operations',
  inputSchema,
  outputSchema,
  annotations: {
    readOnlyHint: true,
    idempotentHint: true,
  },
  examples: [
    {
      description: 'Add two numbers',
      input: { operation: 'add', a: 2, b: 3 },
      output: { result: 5, operation: 'add' },
    },
  ],
})
class CalculateTool extends ToolContext {
  async execute(input) {
    await this.notify(`Calculating ${input.operation}(${input.a}, ${input.b})`, 'debug');

    let result: number;
    switch (input.operation) {
      case 'add': result = input.a + input.b; break;
      case 'subtract': result = input.a - input.b; break;
      case 'multiply': result = input.a * input.b; break;
      case 'divide':
        if (input.b === 0) this.fail(new InvalidInputError('Division by zero'));
        result = input.a / input.b;
        break;
    }

    return { result, operation: input.operation };
  }
}

@App({ name: 'calculator', tools: [CalculateTool] })
class CalculatorApp {}

@FrontMcp({
  info: { name: 'Calculator', version: '1.0.0' },
  apps: [CalculatorApp],
})
export default class CalculatorServer {}