One governed MCP surface
Expose Firebird without handing the model an unrestricted database connection.
Firebird · MCP
Connect AI clients to Firebird through hs-sql-agent's MCP surface, typed SQL compiler, access policy, Safe DML workflow, and audit boundary.
Expose Firebird without handing the model an unrestricted database connection.
Keep Firebird-specific SQL semantics inside an explicit source/target capability boundary.
Apply database scope, table policy, tool restrictions, rate limits, Safe DML, and audit before commit.
hs-sql-agent does not treat a model-generated Firebird statement as trusted simply because the provider could execute it. SQL first enters the typed validation and capability pipeline.
Provider support means the runtime can connect, inspect metadata, compile supported statements, and execute them under policy. It does not mean every vendor-specific syntax form is accepted automatically.
MCP clients can discover schemas, tables, and columns through the built-in metadata tools before constructing Firebird SQL. This reduces blind schema guessing and keeps discovery inside the same authenticated database scope.
The Firebird path follows the same rule as every other provider: unsupported syntax or cross-provider semantics are rejected at the appropriate validation/capability boundary rather than silently rewritten into a query with different behavior.
Firebird does not share a permissive generic-SQL fallback with the other providers. Its syntax and capability checks remain explicit so unsupported forms are rejected before provider execution.
The compiler contract requires Firebird 2.1+ for recursive CTE support and rejects LIMIT as non-Firebird source syntax. Provider-specific rules therefore remain observable instead of disappearing behind a common MCP tool name.
| Compiler contract example | Behavior |
|---|---|
WITH RECURSIVE ... FROM RDB$DATABASE | Requires Firebird 2.1+ when the declared server version is evaluated. |
SELECT id FROM users LIMIT 5 | Rejected as non-Firebird source syntax. |
These examples are a search-oriented summary of the compiler boundary, not a complete SQL compatibility matrix. Unsupported or unproven semantics continue to fail closed.
The MCP tool surface is shared, but each database keeps its own source grammar, capability checks, and provider-specific rendering rules.
Direct database credentials make the model or MCP client responsible for everything the database account can do. hs-sql-agent keeps the real Firebird connection server-side and evaluates SQL against the compiler, MCP-key scope, table policy, tool restrictions, and runtime limits before execution.
That keeps raw SQL available as an expressive agent interface without turning generated SQL into unrestricted database authority.