# Welcome to swarmvia

## Introduction

swarmvia gives agents and teammates access to PostgreSQL or MySQL. They work
from real tables and columns for more accurate results, without putting database
passwords on every laptop. Each **pool** holds the credential and admits
in-flight queries up to your concurrency limit.

Agents connect at [https://swarmvia.com/mcp](https://swarmvia.com/mcp).
There is no token to paste. Scripts call the pool hostname on
`*.swarmvia.cloud` or take a [concurrency lock](/docs/api/locks). HTTPS APIs
use the same pool model when a vendor or your own service has a hard shared
limit.

swarmvia is not an API gateway and not an LLM gateway. Proxy when you want
swarmvia to call upstream. Use locks when you front a public endpoint or keep
the origin client in your process. For SaaS origins with account-level
concurrency limits, see the [knowledge base](/docs/knowledge-base).

## How it fits together

1. Create a **pool** and point it at one or more allowed origins.
2. Choose **managed** custody (swarmvia holds and signs upstream credentials)
   or **pass-through** (your client sends upstream auth; swarmvia relays it).
3. Mint a **pool key** and call `https://‹pool›.swarmvia.cloud/...` with that key.
4. Tune concurrency, queue depth, RPM, retries, and optional response cache on
   the pool's Concurrency settings.
5. When several pools share one origin concurrency limit, put them on a
   [Capacity](/docs/capacity) budget. Fixed caps each pool at its allocation.
   Auto keeps reserved pins local and moves float toward load.
6. Use the pool's [Metrics](/docs/pools/metrics) tab for admit/queue/reject proof.
   [Billing](/docs/billing) remains the place for request allowance.

## Next steps

- [Quickstart](/docs/quickstart)
- [Pools](/docs/pools)
- [Capacity](/docs/capacity)
- [Agents](/docs/agents)
- [Metrics](/docs/pools/metrics)
- [Concurrency locks API](/docs/api/locks)
- [Credentials](/docs/credentials) · [Domains](/docs/domains) · [IP Policies](/docs/ip-policies)
- [Knowledge base](/docs/knowledge-base)