portail 2.1.0

Unified proxy/gateway: AI Gateway + MCP Gateway + CDN cache
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

# Portail config — /etc/portail/config.toml
listen = "0.0.0.0:8787"
mcp_socket = "/run/portail/mcp.sock"
cache_dir = "/var/cache/portail"
cache_size = "10g"

[ai_gateway]
enabled = true
upstream = "http://127.0.0.1:4000"
default_provider = "anthropic"

# ── Upstream Target Templates ─────────────────────────────────────
# Create, reuse, and share across teams. Each target = a provider
# endpoint with model allowlist, rate limit, and tags.
#
# Set API keys via env vars: $ANTHROPIC_API_KEY, $OPENAI_API_KEY, etc.
# Export a target:    portail target export anthropic-fast
# List available:     portail target list
[[targets]]
name = "anthropic-fast"
provider = "anthropic"
base_url = "https://api.anthropic.com/v1"
api_key = "$ANTHROPIC_API_KEY"
models = ["claude-sonnet-4-20250514", "claude-haiku-3-20250313"]
rps = 10
tags = ["production", "fast"]

[[targets]]
name = "openai-gpt5"
provider = "openai"
base_url = "https://api.openai.com/v1"
api_key = "$OPENAI_API_KEY"
models = ["gpt-5.4", "gpt-5.2"]
rps = 10
tags = ["production"]

[[targets]]
name = "google-gemini"
provider = "google"
base_url = "https://generativelanguage.googleapis.com/v1beta"
api_key = "$GOOGLE_API_KEY"
models = ["gemini-2.5-flash"]
rps = 15

# ── MCP Server Registry ───────────────────────────────────────────
# Built-in MCP servers ship with portail. Configure which to
# autostart and pass them to the Python sidecar on boot.
#
# List available:     portail mcp list
# Show server info:   portail mcp info filesystem
# Get config block:   portail mcp config playwright
[mcp]
enabled = true
socket_path = "/run/portail/mcp.sock"

[[mcp.server_registry]]
name = "filesystem"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/"]
autostart = false
tags = ["built-in", "code"]

[[mcp.server_registry]]
name = "github"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
autostart = false
tags = ["built-in", "git"]

[[mcp.server_registry]]
name = "playwright"
transport = "stdio"
command = "npx"
args = ["-y", "@playwright/mcp"]
autostart = false
tags = ["built-in", "browser"]

[[mcp.server_registry]]
name = "fetch"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-fetch"]
autostart = false
tags = ["built-in", "web"]

[[mcp.server_registry]]
name = "brave-search"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-brave-search"]
autostart = false
tags = ["built-in", "search"]

[[mcp.server_registry]]
name = "sqlite"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sqlite", "./data.db"]
autostart = false
tags = ["built-in", "database"]

[[mcp.server_registry]]
name = "sequential-thinking"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
autostart = false
tags = ["built-in", "reasoning"]

# ── CDN Cache ─────────────────────────────────────────────────────
[cdn]
enabled = false
origin = "http://127.0.0.1:9000"
cache_dir = "/var/cache/portail"
cache_size = "10g"
domains = ["cdn.example.com"]