← All projects
PLATFORM · ADVENSIS

ADV-MCPGateway & mcp-kit

One place for services to publish their MCP tools, and for agents to find and call them.

I designed the architecture of a stateless microservice that registers MCP tools and routes calls to them, plus mcp-kit, the library services use to plug in. Tools live in a Postgres registry, and agents search them by meaning through pgvector.

Key decisions

  • Push-based self-registration. Services announce their own tools, so the gateway works on any runtime — no Kubernetes CRDs.
  • Deterministic WorkItem hook engine. Covers the event flow we needed without running Kafka.
  • Stateless gateway, state in Postgres. Scale by adding replicas.
  • Dual-write notifications for change events.
Python · PostgreSQL · pgvector · Kubernetes