Your service.
Part of Railgrid.
Connect your service to Railgrid workspaces. Build the APIs, interfaces, and tools your users need.
One provider. Three ways to use it.
Create the same resource through the interface you prefer.
Create a database.
- Engine
- PostgreSQL
- Size
- Small
Values are fixed for this demonstration.
Apply a manifest.
apiVersion: databases.example.io/v1
kind: Database
metadata:
name: app-dev
spec:
engine: postgres
size: smallCall an MCP tool.
“Create a small Postgres database called app-dev.”
create_database({
"name": "app-dev",
"engine": "postgres",
"size": "small"
})Workspace databases
0 databasesNo database yet.
Choose an interface and create app-dev. Its details will appear here.
app-dev
Database- Engine
- PostgreSQL
- Size
- Small
app-dev.db.example:5432Illustrative address for this demo.
All three interfaces lead to the same resource.
You build A portal UI that creates a Database resource.
Railgrid connects Workspace context and routing for your UI.
Portal UI guideYou build The Database schema and the controller that provisions it.
Railgrid connects Your resource API to each enabled workspace.
Resource API guideYou build An MCP tool that creates the same Database resource.
Railgrid connects Tool discovery through the workspace MCP endpoint.
MCP guideYou build your service.
Your logic and the interfaces it needs.
Your provider runs independently. Build resource schemas, controllers, portal UI, and MCP handlers as your service needs them.
Explore extension pointsRailgrid connects it.
Registration, workspace API bindings, routing, and MCP discovery.
How providers workStart with a working provider.
The quickstart is a working hello provider, separate from the illustrative database demo above. Build it locally, change its hello response, and verify the new response in the portal.
Build the hello provider- 01
Build locally
Run the provider and verify its hello response through the portal.
- 02
Package and register
Ship an image and chart; a hub administrator registers the provider.
- 03
Enable in a workspace
A workspace member accepts its declared permissions and enables its capabilities.
Add the interfaces your service needs.
Implement the parts your service calls for. Start with one and add others when they help.
Resource APIs
Define the workspace resources and permission claims your service needs.
Controllers
Reconcile resources across workspaces bound to your APIExport.
Portal UI
Build a Web Component that receives workspace and portal context.
MCP tools
Expose tools through the hub while honoring caller identity and workspace access.
More examples: Template authoringMCP reference
Contributing to Railgrid itself? Explore the core repository.