Programmatic Usage

import { serve } from '@gizatech/mcp-server';

// Reads env vars, registers all tools, starts stdio transport
await serve();

await serve({ transport: 'http', port: 3001 });

import { Giza, Chain } from '@gizatech/agent-sdk';
import {
  createGizaServer,
  resolveConfig,
  portfolioTools,
  protocolTools,
  walletTools,
} from '@gizatech/mcp-server';

const config = resolveConfig({
  giza: new Giza({ chain: Chain.BASE }),
  tools: [...walletTools, ...protocolTools, ...portfolioTools],
});

const server = createGizaServer(config);
await server.stdio();

const config = resolveConfig({
  giza: new Giza({ chain: Chain.BASE }),
  systemPrompt: `You are a savings assistant for Acme Finance.
Help users deposit funds and monitor their yield.
Always be concise and use plain language.`,
});

const server = createGizaServer(config);
await server.stdio();

import { z } from 'zod';
import type { ToolDefinition } from '@gizatech/mcp-server';
import { textResult } from '@gizatech/mcp-server';

const myCustomTool: ToolDefinition = {
  name: 'get_greeting',
  description: 'Return a personalized greeting for the user.',
  inputSchema: z.object({
    name: z.string().min(1, 'Name is required'),
  }),
  async handler(_ctx, input) {
    const name = input['name'] as string;
    return textResult(`Hello, ${name}! Welcome to Giza.`);
  },
};

import { createGizaServer, resolveConfig, allTools } from '@gizatech/mcp-server';

const config = resolveConfig({
  giza: new Giza({ chain: Chain.BASE }),
  tools: [...allTools, myCustomTool],
});

const server = createGizaServer(config);
await server.stdio();

interface ToolDefinition {
  name: string;
  description: string;
  inputSchema: z.ZodObject<z.ZodRawShape>;
  handler: (ctx: ToolContext, input: Record<string, unknown>) => Promise<ToolResult>;
}

import { textResult, jsonResult, errorResult } from '@gizatech/mcp-server';

// Plain text response
return textResult('Operation completed successfully.');

// JSON response (pretty-printed)
return jsonResult({ apr: 5.42, protocol: 'aave' });

// Error response
return errorResult('Invalid token address.');

import { GizaServer } from '@gizatech/mcp-server';

const server = new GizaServer(resolvedConfig);

// Access the underlying McpServer for advanced MCP features
server.mcp.resource(/* ... */);

// Connect transport
await server.stdio();
// or
await server.http({ port: 3000 });

import type {
  ToolDefinition,
  ToolContext,
  ToolResult,
  ServerConfig,
  ResolvedServerConfig,
} from '@gizatech/mcp-server';