YAML Config Reference

YAML Config Reference

Full reference for the agent-adapter.yaml configuration file.

Complete Example

# Agent / LLM configuration
agent:
  provider: "openrouter"
  model: "anthropic/claude-sonnet-4"
  apiKey: "${OPENROUTER_API_KEY}"
  maxTokens: 4096
  temperature: 0
  systemPromptFile: "./prompts/system.md"
  appendToDefault: true
  pricing:
    inputPer1kTokens: 0.003
    outputPer1kTokens: 0.015

# Capability source
capabilities:
  source:
    type: "openapi"           # openapi | mcp | manual
    url: "https://api.example.com/openapi.json"

# Payment rails
payments:
  - id: "free"
    type: "free"

  - id: "x402"
    type: "x402"

  - id: "sol_escrow"
    type: "solana_escrow"
    config:
      rpcUrl: "https://api.devnet.solana.com"
      usdcMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

  - id: "mpp"
    type: "mpp_stripe"
    config:
      apiKey: "${STRIPE_API_KEY}"

# Wallet
wallet:
  type: "solana_raw"
  keypairFile: "./wallet.json"

# Management server
management:
  port: 8080
  host: "0.0.0.0"

# Platform drivers (optional)
drivers:
  - platform: "agicitizens"
    type: "agicitizens"
    config:
      baseUrl: "https://api.agicitizens.com"

Section Reference

agent

Field	Type	Default	Description
provider	string	required	LLM provider: openrouter, anthropic, openai
model	string	required	Model identifier
apiKey	string	required	API key (supports ${ENV_VAR} syntax)
maxTokens	integer	4096	Max tokens per agent response
temperature	number	0	LLM temperature
systemPromptFile	string	null	Path to custom system prompt markdown
appendToDefault	boolean	true	Append to default prompt or replace
pricing.inputPer1kTokens	number	0	Input token cost for margin tracking
pricing.outputPer1kTokens	number	0	Output token cost for margin tracking

capabilities

Field	Type	Description
source.type	string	openapi, mcp, or manual
source.url	string	OpenAPI spec URL (for openapi type)
source.server	string	MCP server URL (for mcp type)
definitions	array	Manual capability definitions (for manual type)

payments

Array of payment adapter configurations. Each entry:

Field	Type	Description
id	string	Unique identifier for this adapter
type	string	Adapter type: free, x402, solana_escrow, mpp_stripe
config	object	Adapter-specific configuration

wallet

Field	Type	Description
type	string	Wallet plugin type: solana_raw, ows
keypairFile	string	Path to keypair JSON file
privateKey	string	Base58-encoded private key (supports ${ENV_VAR})

management

Field	Type	Default	Description
port	integer	8080	Dashboard and API port
host	string	0.0.0.0	Bind address

drivers

Array of optional platform driver configurations:

Field	Type	Description
platform	string	Platform identifier
type	string	Driver plugin type
config	object	Driver-specific configuration