***

title: run
slug: /reference/typescript/agents/agent-server/run
description: Start the multi-agent HTTP server.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

Start the HTTP server and begin listening for requests. Uses `@hono/node-server`
to serve the Hono application with all registered agents.

## **Parameters**

<ParamField path="host" type="string" toc={true}>
  Override the configured hostname.
</ParamField>

<ParamField path="port" type="number" toc={true}>
  Override the configured port.
</ParamField>

## **Returns**

`Promise<void>` -- Resolves after starting the HTTP server.

<Note>
  For custom server setups — such as embedding the agents into an existing Hono application —
  use `getApp()` to retrieve the underlying Hono app and pass its `fetch` handler to
  your own `@hono/node-server` `serve()` call instead of using `run()`.
</Note>

## **Example**

```typescript {8}
import { AgentBase, AgentServer } from '@signalwire/sdk';

const agent = new AgentBase({ name: 'my-agent', route: '/agent' });
agent.setPromptText('You are a helpful assistant.');

const server = new AgentServer({ host: '0.0.0.0', port: 3000 });
server.register(agent);
await server.run();
```