import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';
import { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';

interface Tool {
    name: string;
    title: string;
    description: string;
    parameters: z.ZodObject<any>;
    annotations: ToolAnnotations;
    execute: (params: any) => Promise<string>;
}
interface DevelopersApi {
    listServices(): Promise<string>;
    getDocumentation(serviceId: string): Promise<string>;
    getDocumentationSection(serviceId: string, sectionId: string): Promise<string>;
    getDocumentationPage(pagePath: string): Promise<string>;
    getApiOperations(apiSpecificationPath: string): Promise<string>;
    getApiOperationDetails(apiSpecificationPath: string, method: string, path: string): Promise<string>;
    fetchGithubGuide?(url: string): Promise<string>;
}
interface ToolContext {
    client: DevelopersApi;
    serviceId?: string;
    apiSpecificationPath?: string;
}

declare const tools: (context: ToolContext) => Tool[];

interface MastercardDevelopersAgentToolkitConfig {
    service?: string;
    apiSpecification?: string;
}
declare class MastercardDevelopersAgentToolkit extends McpServer {
    constructor(config?: MastercardDevelopersAgentToolkitConfig);
    private registerAllTools;
}
declare function buildContext(config: MastercardDevelopersAgentToolkitConfig): ToolContext;

export { type DevelopersApi, MastercardDevelopersAgentToolkit, type MastercardDevelopersAgentToolkitConfig, type Tool, type ToolContext, buildContext, tools };