Decorators Overview

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

@Tool({
  name: 'get_user',
  description: 'Fetch user by ID',
  inputSchema: { userId: z.string() },
})
class GetUserTool extends ToolContext {
  async execute(input: { userId: string }) {
    const db = this.get(DatabaseToken);
    return db.findUser(input.userId);
  }
}

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

const getUserTool = tool({
  name: 'get_user',
  description: 'Fetch user by ID',
  inputSchema: { userId: z.string() },
})((input, ctx) => {
  const db = ctx.get(DatabaseToken);
  return db.findUser(input.userId);
});

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

const metadata = {
  name: 'calculate',
  inputSchema: { a: z.number(), b: z.number() },
  outputSchema: z.object({ result: z.number() }),
} as const;

// Types are inferred automatically
type Input = ToolInputOf<typeof metadata>;   // { a: number; b: number }
type Output = ToolOutputOf<typeof metadata>; // { result: number }

// Types are auto-inferred from the @Tool decorator — use plain `ToolContext`.
@Tool(metadata)
class CalculateTool extends ToolContext {
  async execute(input: Input): Promise<Output> {
    return { result: input.a + input.b };
  }
}

// Dependency injection
const service = this.get(ServiceToken);
const optional = this.tryGet(OptionalToken);

// Scope access
const tools = this.scope.tools;

// Logging
this.logger.info('Processing request');

// Request context
const ctx = this.context;
const auth = this.context.authInfo;

import { Tool, Resource, Prompt, Agent, Skill, Job, App } from '@frontmcp/sdk';

// Pull a named export from an installed npm package
const OpenAI_GenImage = Tool.esm('@some-org/some-package', 'generate_image');

// Pull from a remote MCP server
const SearchAPI = Tool.remote('https://search.example.com/mcp', 'search');

@FrontMcp({
  info: { name: 'gateway', version: '1.0.0' },
  tools: [
    Tool.esm('@some-org/some-package', 'generate_image'),
    Tool.remote('https://search.example.com/mcp', 'search'),
  ],
})
class Gateway {}