Skip to main content
Glama

Server Details

Generate realistic, FK-consistent synthetic test data for your databases from your AI assistant.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
marcelglaeser/seedbase-node
GitHub Stars
0

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsA

Average 4.1/5 across 6 of 6 tools scored.

Server CoherenceA
Disambiguation5/5

Each tool has a distinct, non-overlapping purpose: project creation, schema import, DDL retrieval, data generation, generation status polling, and project listing. No ambiguity.

Naming Consistency5/5

All tool names follow a consistent verb_noun snake_case pattern (e.g., create_project, list_projects, get_ddl), making them predictable and easy to understand.

Tool Count5/5

With 6 tools, the set is well-scoped for the domain of test data generation, covering the core workflow without being overly large or trivial.

Completeness5/5

The tools cover the full lifecycle: project creation, schema import, DDL retrieval, data generation with async polling, and project listing. No obvious gaps for the intended use case.

Available Tools

6 tools
create_projectCreate projectAInspect

Create a new, empty SeedBase project. Use import_schema afterwards to add the schema.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesProject name
db_typeNoTarget database type (default: postgresql)

Output Schema

ParametersJSON Schema
NameRequiredDescription
idYes
nameYes
db_typeYes
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations provide minimal behavioral info (readOnlyHint false, destructiveHint false). The description adds no additional details about side effects, permissions, or error states beyond stating the creation action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no unnecessary words, front-loaded with the action. Every sentence serves a purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple creation tool with an output schema and clear next steps, the description is mostly complete. It could mention return value or error conditions, but the hint about import_schema adds value.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for both parameters (name and db_type). The description adds no extra parameter-specific information, so it meets the baseline but does not exceed it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Create'), resource ('new, empty SeedBase project'), and provides a hint about the next step ('Use import_schema afterwards'), making it distinct from sibling tools like import_schema or list_projects.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear context on when to use this tool (to create an empty project) and explicitly mentions the next step (import_schema), but does not cover when not to use it or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

fetch_generationFetch generation resultA
Read-onlyIdempotent
Inspect

Fetch a previously started generation by id: returns its status, and the SQL INSERT statements once completed. Use this when generate_test_data reported the generation as still running.

ParametersJSON Schema
NameRequiredDescriptionDefault
generation_idYesThe generation id (UUID) reported by generate_test_data

Output Schema

ParametersJSON Schema
NameRequiredDescription
sqlNoComplete SQL INSERTs. Absent when the result is too large — download it from download_url instead; no partial SQL is ever returned.
statusYes
sql_charsNo
truncatedNoTrue when the SQL was too large to inline. The response then contains NO sql; fetch the complete file from download_url.
download_urlNoAuthenticated download endpoint for the complete SQL (send your API key as 'Authorization: Bearer …').
generation_idYes
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and destructiveHint=false, so the description's safety profile is clear. The description adds that it returns status and SQL INSERT statements, which is useful but not critical beyond the schema's coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences: first states purpose and outputs, second states usage context. It is front-loaded and contains no unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter, an output schema, and clear annotations, the description provides all necessary information: what it does, what it returns, and when to use it. Sibling tools provide surrounding context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the description does not add additional semantics about the generation_id parameter beyond what the schema's description already provides. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool fetches a generation by id, returns status and SQL INSERT statements. It distinguishes from siblings like generate_test_data (which starts generation) and other tools that create projects or list projects.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says to use this when 'generate_test_data reported the generation as still running', providing a clear when-to-use condition. It does not explicitly state when not to use, but the condition is sufficient for the agent to decide.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_test_dataGenerate test dataAInspect

Generate a fresh synthetic dataset for a project and return it as SQL INSERT statements. Optionally set rows per table. The data is foreign-key consistent.

ParametersJSON Schema
NameRequiredDescriptionDefault
rowsNoRows per table (optional; plan limits apply)
seedNoSeed for deterministic output (optional)
projectYesProject id (UUID) or project name

Output Schema

ParametersJSON Schema
NameRequiredDescription
sqlNoComplete SQL INSERTs. Absent when the result is too large — download it from download_url instead; no partial SQL is ever returned.
statusYes
sql_charsNo
truncatedNoTrue when the SQL was too large to inline. The response then contains NO sql; fetch the complete file from download_url.
download_urlNoAuthenticated download endpoint for the complete SQL (send your API key as 'Authorization: Bearer …').
generation_idYes
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds value beyond annotations by specifying output format (SQL INSERT), foreign-key consistency, and freshness of data. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two focused sentences: first states purpose and output, second adds key details. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Missing explanation of the 'seed' parameter and prerequisites. With an output schema present, the description is adequate but not thorough for a data generation tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers all parameters 100%. The description adds meaning for 'rows' and implies data quality but does not explain the 'seed' parameter, which is important for deterministic output.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: generate a synthetic dataset and return it as SQL INSERT statements. It distinguishes from sibling tools like create_project or fetch_generation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides some usage context (optional rows, foreign-key consistent) but does not explicitly state when to use vs alternatives or any prerequisites (e.g., project must exist).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_ddlGet schema DDLA
Read-onlyIdempotent
Inspect

Get a project's schema as CREATE TABLE statements. Accepts a project id or name and an optional SQL dialect (postgresql, mysql, sqlite, mssql).

ParametersJSON Schema
NameRequiredDescriptionDefault
dialectNoSQL dialect for the DDL (default: the project's database type)
projectYesProject id (UUID) or project name

Output Schema

ParametersJSON Schema
NameRequiredDescription
ddlYes
dialectYes
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already provide readOnlyHint=true, idempotentHint=true, destructiveHint=false, indicating a safe, non-destructive operation. The description adds that the output is DDL (CREATE TABLE statements), which is useful behavioral context beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences, front-loaded with the key action, and contains no unnecessary words. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (2 parameters, no nested objects, output schema exists), the description sufficiently covers purpose, inputs, and optionality. It is complete for an AI agent to understand and use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers 100% of parameters with descriptions. The description repeats that project accepts id or name and dialect is optional with allowed values, adding no net new information beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get' and the resource 'project's schema as CREATE TABLE statements'. It distinguishes from sibling tools (fetch_generation, generate_test_data, list_projects) which deal with data generation and project listing, making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what the tool does and the inputs (project id/name, optional dialect). While it doesn't explicitly state when not to use it or name alternatives, the context of sibling tools and the clear purpose provide adequate guidance for an AI agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

import_schemaImport schemaA
Destructive
Inspect

Import a database schema into a project from pasted content: SQL DDL (CREATE TABLE …, raw pg_dump/mysqldump schema output works), SQL INSERT dumps, CSV/TSV, JSON, or ORM model code (Django, Prisma, SQLAlchemy, …). Replaces the project's current schema.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoOptional hint: sql, csv, tsv, json, or an ORM name (django, prisma, sqlalchemy, …). Auto-detected when omitted.
contentYesThe schema source text (e.g. the DDL)
projectYesProject id (UUID) or project name

Output Schema

ParametersJSON Schema
NameRequiredDescription
tablesNo
fk_countYes
warningsNo
table_countYes
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint: true, and the description reinforces this by stating 'Replaces the project's current schema.' It adds context about supported formats and auto-detection, but does not contradict annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise: two sentences, no redundant information, front-loaded with the core purpose. Every word is necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (multiple input formats, replacement behavior), the description covers all essential aspects: supported formats, auto-detection, and the replacement effect. Output schema is present but not needed in description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema coverage, the description adds meaning by explaining that 'format' is optional and auto-detected, and lists example formats. This goes beyond the schema's basic property descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: importing a database schema from various formats (SQL DDL, CSV/TSV, JSON, ORM code). It specifies the action verb 'Import' and the resource 'database schema into a project', and distinguishes from sibling tools like create_project or generate_test_data.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when pasting schema content, but does not explicitly state when not to use it or mention alternatives. Sibling tools are not referenced, and no contextual guidance is provided for choosing this tool over others.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_projectsList projectsA
Read-onlyIdempotent
Inspect

List your SeedBase projects (id, name, database type). Use this first to find the project to work with.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
projectsYes
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already provide readOnlyHint, idempotentHint, destructiveHint, so the description's mention of returned fields adds minor context, but no new behavioral traits beyond annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with purpose, then usage advice. No extraneous words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple, parameterless tool with output schema, the description fully covers purpose and usage context. No gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist (schema coverage 100%), so the description is not required to add meaning; baseline 4 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it lists SeedBase projects with specific fields (id, name, database type), using a specific verb and resource, and distinguishes it from siblings by noting it's the first step.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly says 'Use this first to find the project to work with,' indicating it's the entry point for other tools like fetch_generation or get_ddl, though it doesn't mention when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.