Non-agentic HTTP traffic

Use the agentgateway binary to route HTTP traffic to a simple backend (httpbin) running locally.

  flowchart LR
    A[client] -->|localhost:3000| B[agentgateway]
    B --> C[httpbin]

The client sends requests to agentgateway on port 3000.
Agentgateway forwards the requests to the httpbin backend based on the route and backend configuration.
Httpbin responds, and agentgateway returns the response back to the client.

Before you begin

Install the agentgateway binary.

curl -sL https://agentgateway.dev/install | bash

Install Docker to run httpbin.

Steps

Step 1: Start httpbin in Docker

Run the httpbin image so it listens on port 80 inside the container. Map it to a host port such as 8000 so that agentgateway can reach it.

docker run --rm -d -p 8000:80 --name httpbin kennethreitz/httpbin

docker run --rm -d -p 8000:80 --name httpbin kennethreitz/httpbin --platform linux/amd64

Verify that httpbin responds.

curl -s http://localhost:8000/headers | head -20

Example output:

{
  "headers": {
    "Accept": "*/*", 
    "Host": "localhost:8000", 
    "User-Agent": "curl/8.7.1"
  }
}

Step 2: Create the agentgateway configuration

Create a config.yaml that listens on port 3000 and routes traffic to the httpbin host. Use a static host backend with the address and port where httpbin is reachable, such as 127.0.0.1:8000.

cat > config.yaml << 'EOF'
# yaml-language-server: $schema=https://agentgateway.dev/schema/config
binds:
- port: 3000
  listeners:
  - protocol: HTTP
    routes:
    - backends:
      - host: 127.0.0.1:8000
EOF

Step 3: Start agentgateway

In a separate terminal, run agentgateway with the config file.

agentgateway -f config.yaml

Example output:

info  state_manager  loaded config from File("config.yaml")
info  app            serving UI at http://localhost:15000/ui
info  proxy::gateway started bind  bind="bind/3000"

Step 4: Send a request through agentgateway

Send a request to agentgateway on port 3000. Agentgateway forwards it to httpbin; the response is returned to you.

curl -i http://localhost:3000/headers

Example response (status and headers):

HTTP/1.1 200 OK
content-type: application/json
...

Example JSON body:

{
  "headers": {
    "Accept": "*/*", 
    "Host": "localhost:3000", 
    "User-Agent": "curl/8.7.1"
  }
}

You can try other httpbin endpoints through agentgateway, such as the following.

curl -s http://localhost:3000/get
curl -s http://localhost:3000/post -X POST -H "Content-Type: application/json" -d '{"key":"value"}'

Step 5 (Optional): Stop httpbin

When you are done, stop and remove the httpbin container.

docker stop httpbin

Next steps

Traffic management

Control and route traffic through agentgateway.

Resiliency

Simulate failures, disruptions, and adverse conditions to ensure gateway and app resilience.

Security

Secure backends and routes with authentication, authorization, and rate limiting policies.

MCP servers