genskill-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@genskill-mcp Scaffold a new storage Intelligent Contract"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
genskill-mcp
An MCP server that lets any AI agent build on GenLayer: search the docs, inspect contracts and transactions over RPC, and scaffold, lint, and test Intelligent Contracts.
genskill-mcp is a Model Context Protocol server for MCP-compatible clients (Claude Code, Cursor, VS Code, Gemini CLI, Codex, and remote MCP clients over HTTP). It combines searchable GenLayer documentation, live protocol/RPC inspection of contracts and transactions, and a contract authoring toolkit (scaffold, lint, and test Intelligent Contracts), so an agent can go from zero to a deployable contract without leaving its editor.
This project does not sign transactions or manage private keys. It supports live node inspection and contract interaction through GenLayer JSON-RPC methods such as gen_call, gen_getContractState, gen_getContractCode, gen_getContractSchema, gen_getTransactionStatus, and gen_getTransactionReceipt.
Install
Use | Command / URL |
Local (stdio) |
|
Hosted (remote) |
|
Per-client setup (Claude Code, Cursor, VS Code, Gemini, Codex, remote) is in the quickstarts below.
Related MCP server: GenLayer MCP Server
What this server does
The server loads the official GenLayer docs bundle:
It parses that bundle into sections and exposes:
searchable MCP tools
a browsable docs index resource
individual section resources
live GenLayer JSON-RPC tools for contract and transaction inspection
a browsable RPC configuration resource
contract authoring tools: scaffold a starter contract and lint it before deploy
guided MCP prompts for writing, testing, and debugging contracts
This repository supports two transports:
stdiofor local CLI tools such as Claude Code, Codex, Cursor, VS Code, and Gemini CLIStreamable HTTP for deployed remote MCP usage
Build a contract (authoring tools, new in 2.2)
If you are new to GenLayer, this is the fast path from zero to a deployable contract. It does not just point you at docs, it gives you working code and checks it.
genlayer_scaffold_contractgenerates a working starter Intelligent Contract for a template (storage,llm-judge,web-oracle,token). The output already has the runner header pinned and avoids the common GenVM deploy-killers, so it deploys as-is.genlayer_lint_contractruns static pre-deploy checks on contract source. It catches the mistakes that make a deploy finalize with a bareinvalid_contract(no stack trace): a comment line directly under the runner header, an unpinned or:test/:latestrunner, a missinggl.Contractclass, forbidden sandbox imports (os,sys,subprocess,random, ...), and GenVM Python-subset issues such asforloops,sorted,.sort,lambda, andlist/dictstorage fields.genlayer_scaffold_testgenerates a fast direct-mode test (genlayer-test) for a template, using the real fixtures (direct_vm,direct_deploy,direct_alice) and mocking web/LLM calls so tests stay deterministic.
Three guided prompts wrap the workflow for any MCP client:
genlayer_write_contractscaffold, decide what needs consensus, then lint.genlayer_test_contractdirect-mode then integration testing.genlayer_debug_deploythe checklist for a deploy that errored on-chain.
And a single always-available resource, genlayer://guide/contract-rules, is
an authoritative cheat sheet (skeleton, storage types, web/LLM/equivalence APIs,
the GenVM Python-subset rules, and the deploy/finalize/debug checklist) that any
connecting agent can read to get contract writing and debugging right. It tracks
the latest GenLayer docs and the official write-contract / direct-tests skills.
Typical loop: scaffold, edit, genlayer_lint_contract until it is clean, deploy,
then inspect it live with genlayer_get_contract_snapshot.
RPC configuration
Live protocol tools use the configured GenLayer RPC endpoint.
GENLAYER_RPC_URL: JSON-RPC endpoint to useGENLAYER_RPC_TIMEOUT_MS: timeout for live RPC requests
If GENLAYER_RPC_URL is not set, the server defaults to:
https://studio.genlayer.com/apiQuickstart for Claude Code
claude mcp add --transport stdio genskill -- npx -y genskill-mcpThen start Claude Code:
claudeInside Claude Code, run:
/mcpThe genskill server and its tool endpoints should be listed.
Quickstart for Cursor (per-project)
Add this to .cursor/mcp.json:
{
"mcpServers": {
"genskill": {
"command": "npx",
"args": ["-y", "genskill-mcp"]
}
}
}If a Cursor version does not recognizemcpServers, use mcp_servers as the top-level key instead.
Quickstart for VS Code (per-workspace)
Add this to .vscode/mcp.json:
{
"servers": {
"genskill": {
"type": "stdio",
"command": "npx",
"args": ["-y", "genskill-mcp"]
}
},
"inputs": []
}Quickstart for Gemini CLI
Add the MCP server globally:
gemini mcp add --scope user genskill npx -y genskill-mcpConfirm it is registered:
gemini mcp listQuickstart for Codex
Add the MCP server with the Codex CLI:
codex mcp add genskill -- npx -y genskill-mcpConfirm it is registered:
codex mcp listAlternatively, add this to a Codex MCP config:
[mcp_servers.genskill]
command = "npx"
args = ["-y", "genskill-mcp"]Restart Codex if needed so it reloads the MCP config.
Quickstart from source
For source-based usage instead of installing from npm:
Clone the repo:
git clone https://github.com/Jr-kenny/genskill-mcp cd genskill-mcpInstall dependencies and build:
npm install npm run buildRun the local entrypoint:
node /absolute/path/to/genskill-mcp/dist/cli.js
Substitute that node .../dist/cli.js command in any MCP client config for source-based usage over npx.
Quickstart for remote MCP clients
Remote MCP clients can use the public HTTP endpoint without an account. Anonymous clients receive the stateless documentation, authoring, planning, and protocol tools. Persisted workflow sessions require an optional tenant bearer token.
This is not Claude-specific. It is the deployed transport for any client that can connect to remote MCP servers over Streamable HTTP, including chat-style AI apps where that capability is available.
Deploy this repository to Vercel. No authentication configuration is required for public stateless access.
To enable private workflow sessions for known tenants, configure credentials as a JSON object. Each key is a stable tenant ID and each value is a random bearer token containing at least 32 characters:
GENSKILL_MCP_TENANT_TOKENS='{"team-a":"replace-with-a-random-32-character-token"}'Anonymous users never see workflow session tools or resources, even when tenant credentials are configured.
The deployed MCP endpoint is:
https://genskill-mcp.vercel.app/mcpThe deployed service also exposes:
GET /for a small server info responseGET /healthfor health checksPOST /mcpfor MCP Streamable HTTP requests
Add the deployed MCP URL in any remote MCP client. Known tenants can optionally send their token to unlock their isolated workflow sessions:
Authorization: Bearer replace-with-a-random-32-character-token
Use:
https://genskill-mcp.vercel.app/mcpThis applies to Claude-hosted integrations, ChatGPT-style apps, and other remote AI clients where MCP server URLs are supported.
For local HTTP testing, run:
npm install
npm run build
npm run start:httpIt listens on port 3000 by default. Set the PORT environment variable to change it.
HTTP workflow session tools are hidden from anonymous users. Authenticated sessions are stored in separate hashed directories for each tenant. Set GENSKILL_MCP_SESSION_DIR to choose the session root. Vercel defaults to temporary function storage, so use a durable tenant-aware backing store if sessions must survive instance recycling.
Local filesystem access is available only over the stdio transport. HTTP servers don’t register genlayer_load_contract_artifact, and all other HTTP tools reject contractPath. Remote clients can provide base64-encoded code or a deployed contract address.
Vercel deployment
This repository is configured for Vercel through vercel.json and the Web-standard API functions in api/.
Public MCP endpoint on Vercel:
https://genskill-mcp.vercel.app/mcpUseful checks:
https://genskill-mcp.vercel.app/https://genskill-mcp.vercel.app/healthPOST https://genskill-mcp.vercel.app/mcpfrom an anonymous or authenticated MCP client
Notes:
/mcpis routed to the Vercel function at/api/mcp.mjs.Anonymous
/mcprequests expose only stateless tools. A supplied bearer token must be valid, and invalid tokens return401.The Vercel endpoint uses the MCP SDK Web-standard Streamable HTTP transport in stateless mode.
POST requests return JSON responses where possible, which is friendlier for serverless hosting than holding long SSE streams open.
If the docs update while the service is already deployed, call
genlayer_refresh_docsfrom an MCP client or redeploy the project.
Tool endpoints
High-level orchestration tools now use a canonical machine-readable response shape with:
kindsummarycurrent_stateblockersnext_actionsfallbacksdata
The autopilot and capability surfaces are capability-aware: they should prefer only actions supported by the currently configured endpoint and explicitly downgrade unsupported debug or ops paths into fallbacks.
Live protocol tools
genlayer_list_networksLists documented GenLayer network presets, chain IDs, and RPC URLs.genlayer_start_workflow_sessionCreates a persisted workflow session from a generated contract workflow plan.genlayer_list_workflow_sessionsLists persisted workflow sessions ordered by most recently updated.genlayer_get_workflow_sessionReads a persisted workflow session by id.genlayer_update_workflow_stepMarks a workflow session step as completed or pending.genlayer_autopilot_briefGenerates a single operator-grade brief with endpoint capabilities, contract context, workflow plans, handoff steps, and relevant docs.genlayer_load_contract_artifactLoads a local contract artifact or bytecode file and returns base64 plus file metadata. This tool is exposed only over the local stdio transport.genlayer_probe_endpoint_capabilitiesProbes which HTTP and RPC surfaces are actually exposed on the configured GenLayer deployment.genlayer_generate_agent_handoffGenerates an explicit ordered handoff bundle so weaker agents know exactly which genskill-mcp tools to call next.genlayer_get_contract_interfaceNormalizes a contract schema into constructor, view methods, and write methods.genlayer_plan_contract_actionBuilds a schema-validated execution plan for deploy, read, or write actions.genlayer_plan_contract_workflowBuilds a multi-phase contract workflow covering deploy, wait, snapshot, interaction, and diagnosis.genlayer_run_transaction_reportOrchestrates waiting, inspection, status explanation, optional trace lookup, and optional contract snapshot into one report.genlayer_run_contract_reportOrchestrates network context, contract snapshot, interface, workflow, and default plans into one report.genlayer_generate_typescript_workflowGenerates GenLayerJS deploy/read/write snippets from a contract schema or deployed contract.genlayer_generate_contract_playbookGenerates a schema-aware deployment and interaction playbook for a contract.genlayer_node_healthCalls the configured GenLayer node HTTPGET /healthendpoint.genlayer_network_statusReturns a combined live snapshot of node health, chain id, block height, sync status, and optional debug ping status.genlayer_balanceCalls the configured GenLayer HTTPGET /balanceendpoint for the node operator.genlayer_eth_get_balanceCallseth_getBalancethrough the configured GenLayer RPC endpoint.genlayer_raw_rpcCallsgen_*,eth_*,zks_*, orzksync_*methods directly against the configured endpoint.genlayer_trace_transactionCallsgen_dbg_traceTransactionwhen the target node exposes debug methods.genlayer_metricsFetches Prometheus-style metrics from the configured HTTPGET /metricsendpoint.genlayer_submit_raw_transactionSubmits a signed raw transaction througheth_sendRawTransaction.genlayer_inspect_transactionCombinesgen_getTransactionStatus,gen_getTransactionReceipt, andeth_getTransactionByHashinto one response.genlayer_wait_for_transactionPolls transaction status untilacceptedorfinalized.genlayer_explain_transaction_statusInterprets transaction status into finality phase, appealability, and next-step guidance.genlayer_call_contractExecutesgen_callfor read, write-simulation, or deploy-simulation requests.genlayer_get_contract_schemaCallsgen_getContractSchemafor base64-encoded contract code.genlayer_get_contract_stateCallsgen_getContractStatefor a deployed contract.genlayer_get_contract_codeCallsgen_getContractCodefor a deployed contract.genlayer_get_contract_snapshotFetches state, deployed code, and derived schema in one call.genlayer_get_transaction_statusCallsgen_getTransactionStatusfor lightweight transaction polling.genlayer_get_transaction_receiptCallsgen_getTransactionReceiptfor full processed transaction data.genlayer_syncingCallsgen_syncingon the configured endpoint.
Documentation tools
genlayer_search_docsSearches the documentation bundle and returns ranked matches with snippets.genlayer_refresh_docsForce-refreshes the cached GenLayer documentation bundle from the configured source. Use this after the GenLayer team ships new docs, for example new Studio GEN, payable contract, Faucet, Tip Jar, or MetaMask updates.genlayer_read_docReads a section by slug, path, title, or fuzzy query.genlayer_get_doc_by_slugReads a section by exact slug, path, docs URL, or resource URI.genlayer_search_examplesSearches example-heavy sections that contain commands, code blocks, SDK snippets, or config examples.genlayer_get_related_docsFinds related documentation pages based on section path, title, and neighborhood in the docs tree.genlayer_list_topicsLists top-level GenLayer documentation topics with counts and example pages.genlayer_list_sectionsLists available parsed documentation sections.
Resources
genlayer://protocol/networksDocumented GenLayer network presets, RPC URLs, and chain IDs.genlayer://workflow/sessionsList of persisted workflow sessions. HTTP clients see only their authenticated tenant’s sessions.genlayer://workflow/session/{id}Persisted workflow session with step completion state, scoped to the authenticated HTTP tenant.genlayer://workflow/autopilotSingle operator-grade brief for the configured endpoint and current contract context.genlayer://protocol/rpc-configJSON document showing the configured RPC endpoint, timeout, and supported helper methods.genlayer://protocol/capabilitiesProbed endpoint capabilities showing which HTTP and RPC surfaces are actually exposed.genlayer://protocol/transaction/{txId}Combined transaction inspection resource for a specific transaction hash.genlayer://protocol/transaction/{txId}/reportComposed transaction report with status interpretation and optional trace data when exposed.genlayer://protocol/contract/{address}/stateCurrent accepted-state snapshot for a specific deployed contract.genlayer://protocol/contract/{address}/snapshotCombined state, code, and schema snapshot for a specific deployed contract.genlayer://protocol/contract/{address}/playbookSchema-aware deployment and interaction playbook for a deployed contract.genlayer://protocol/contract/{address}/reportComposed contract report with network context, snapshot, interface, workflow, and default plans.genlayer://protocol/contract/{address}/plansDefault workflow plus default read/write action plans for a deployed contract.genlayer://protocol/contract/{address}/method/{method}/plan/{action}Default schema-validated plan for a specific read or write method.genlayer://docs/indexJSON index of all parsed sections.genlayer://docs/section/{slug}Individual documentation sections as read-only resources.
Project structure
File/Folder | Purpose |
| The server logic: loads docs, parses sections, registers tools and resources |
| Entry point that starts the stdio MCP server |
| Contract scaffolder + linter + test scaffolder (pure, unit-tested) |
| Registers the authoring tools and the dev-workflow prompts |
| Shared canonical response envelope helpers |
| Docs loading, caching, parsing, search, and formatting helpers |
| GenLayer RPC, HTTP ops endpoints, network presets, and transaction helpers |
| Schema normalization and GenLayerJS workflow/playbook generation |
| Local artifact loading and hashing for artifact-driven GenLayer workflows |
| Persisted workflow session state and session formatting helpers |
| Vercel API functions for the remote MCP, health, and root endpoints |
| Unit tests for the authoring module ( |
| Compiled JavaScript output generated by |
| Dependencies, scripts, package metadata, and CLI registration |
| TypeScript compiler settings |
| Vercel routing and function configuration |
| Usage and client setup |
How it's built
This MCP server is a lightweight TypeScript implementation built on the official MCP SDK.
Core components
Built on
@modelcontextprotocol/sdkUses
StdioServerTransportfor local MCP clientsUses
zodto validate tool argumentsFetches the GenLayer docs bundle from the official docs site
Parses the bundle into section-level resources based on each
# path/to/file.mdxboundaryUses a simple deterministic ranking function over titles, slugs, paths, and body text
Configuration
Optional environment variables:
GENLAYER_DOCS_URL: alternate source URL or local file path for the docs bundleGENLAYER_DOCS_CACHE_FILE: cache location for the downloaded bundleGENLAYER_DOCS_REFRESH_HOURS: cache freshness window in hours, default24GENLAYER_DOCS_TIMEOUT_MS: HTTP timeout in milliseconds, default15000
The server also refreshes stale in-memory snapshots automatically. For long-running HTTP deployments, call genlayer_refresh_docs when the GenLayer team ships new documentation and an immediate update is needed without restarting the service.
Local development
This section is only for working on the MCP server itself.
npm install
npm run build
npm run check
npm startnpm run check verifies that the server can fetch and parse the live GenLayer docs bundle.
Releasing (maintainers)
Releases are published to npm automatically by .github/workflows/release.yml
when a v* tag is pushed. One-time setup: add an npm automation token as the
NPM_TOKEN repository secret (gh secret set NPM_TOKEN).
To cut a release:
npm version minor # bumps package.json, commits, creates the tag vX.Y.Z
git push --follow-tags # pushes the commit + tag; CI builds, tests, publishesThe workflow checks the tag matches package.json, runs the tests, and publishes
with npm provenance. Once published, consumers update with:
npx -y genskill-mcp@latest # always newest
npm update -g genskill-mcp # if installed globallyRemote (Vercel) users need no action — the hosted endpoint auto-deploys from
main; clients pick up changes on reconnect.
Credits
Built and maintained by:
Available Tools
46 toolsgenlayer_autopilot_briefGenerate GenLayer Autopilot BriefARead-onlyIdempotent
Generate a single high-context operator brief that combines endpoint capabilities, contract context, workflow plans, weak-agent handoff steps, and relevant docs.
Inputs: code, goal, address, contractPath.
genlayer_balanceGet GenLayer BalanceARead-onlyIdempotent
Fetch the node operator balance from the configured GenLayer HTTP /balance endpoint.
Inputs: no named parameters.
genlayer_call_contractExecute GenLayer gen_callA
Execute a live gen_call request for read, write-simulation, or deploy-simulation against the configured GenLayer RPC endpoint.
Inputs: data (required), from (required), type (required), to, +4 more.
genlayer_eth_get_balanceGet EVM Balance Through GenLayerCRead-onlyIdempotent
Call eth_getBalance through the configured GenLayer RPC endpoint.
Inputs: address (required), blockTag.
genlayer_explain_transaction_statusExplain GenLayer Transaction StatusARead-onlyIdempotent
Interpret a GenLayer transaction hash into appealability, finality phase, and likely next step.
Inputs: txId (required), timestamp.
genlayer_generate_agent_handoffGenerate Agent HandoffBRead-onlyIdempotent
Generate an explicit step-by-step GenLayer handoff bundle for weaker agents, including ordered tool usage, fallback paths, and success conditions.
Inputs: code, goal, address, contractPath.
genlayer_generate_contract_playbookGenerate Contract PlaybookBRead-onlyIdempotent
Generate a schema-aware deployment and interaction playbook for a GenLayer contract.
Inputs: code, address, contractPath.
genlayer_generate_typescript_workflowGenerate GenLayer TypeScript WorkflowARead-onlyIdempotent
Generate GenLayerJS deploy/read/write code from a contract schema or deployed contract.
Inputs: code, address, contractPath.
genlayer_get_contract_codeGet GenLayer Contract CodeARead-onlyIdempotent
Fetch the deployed base64 code blob for a GenLayer contract from the configured RPC endpoint.
Inputs: address (required), status, blockNumber.
genlayer_get_contract_interfaceGet GenLayer Contract InterfaceARead-onlyIdempotent
Normalize a contract schema into constructor, view methods, and write methods.
Inputs: code, address.
genlayer_get_contract_schemaGet GenLayer Contract SchemaARead-onlyIdempotent
Derive the schema/interface for base64-encoded GenLayer contract code.
Inputs: code (required).
genlayer_get_contract_snapshotGet GenLayer Contract SnapshotARead-onlyIdempotent
Fetch contract state, deployed code, and derived schema in one call.
Inputs: address (required), status, blockNumber.
genlayer_get_contract_stateGet GenLayer Contract StateARead-onlyIdempotent
Fetch the live state blob for a deployed GenLayer contract from the configured RPC endpoint.
Inputs: address (required), status, blockNumber.
genlayer_get_doc_by_slugGet GenLayer Doc By SlugARead-onlyIdempotent
Read a GenLayer documentation section by exact slug, path, resource URI, or docs URL.
Inputs: slug (required), maxChars.
genlayer_get_transaction_receiptGet GenLayer Transaction ReceiptARead-onlyIdempotent
Fetch the full receipt for a processed GenLayer transaction.
Inputs: txId (required).
genlayer_get_transaction_statusGet GenLayer Transaction StatusARead-onlyIdempotent
Fetch the lightweight consensus status for a GenLayer transaction.
Inputs: txId (required), timestamp.
genlayer_get_workflow_sessionGet Workflow SessionARead-onlyIdempotent
Read a persisted GenLayer workflow session by id.
Inputs: sessionId (required).
genlayer_inspect_transactionInspect TransactionBRead-onlyIdempotent
Combine GenLayer status, GenLayer receipt, and Ethereum transaction lookup for a transaction hash.
Inputs: txId (required), timestamp.
genlayer_lint_contractLint Intelligent ContractARead-onlyIdempotent
Static pre-deploy checks for a GenLayer contract. Catches the mistakes that make a deploy finalize with a bare invalid_contract or fail consensus: a comment directly under the runner header, unpinned/alias runners, missing gl.Contract, and GenVM Python-subset issues (for/sorted/lambda) and storage anti-patterns.
Inputs: code (required).
genlayer_list_networksList GenLayer NetworksARead-onlyIdempotent
List current GenLayer network presets and RPC endpoints from the documented network matrix.
Inputs: no named parameters.
genlayer_list_sectionsList GenLayer Doc SectionsARead-onlyIdempotent
List available GenLayer documentation sections, optionally filtered by prefix text.
Inputs: limit, prefix.
genlayer_list_topicsList GenLayer TopicsARead-onlyIdempotent
List top-level GenLayer documentation topics with section counts and example pages.
Inputs: limit.
genlayer_list_workflow_sessionsList Workflow SessionsARead-onlyIdempotent
List persisted GenLayer workflow sessions ordered by most recently updated.
Inputs: limit.
genlayer_load_contract_artifactLoad Contract ArtifactARead-onlyIdempotent
Load a local contract artifact or bytecode file and return base64 plus file metadata for downstream GenLayer workflows.
Inputs: contractPath (required).
genlayer_metricsGet GenLayer MetricsARead-onlyIdempotent
Fetch Prometheus-style metrics from the configured GenLayer HTTP /metrics endpoint.
Inputs: no named parameters.
genlayer_network_statusGet GenLayer Network StatusARead-onlyIdempotent
Fetch a combined snapshot of GenLayer RPC connectivity, chain id, block height, and syncing status.
Inputs: no named parameters.
genlayer_node_healthCheck GenLayer Node HealthARead-onlyIdempotent
Fetch the configured GenLayer node HTTP health endpoint and return the live response.
Inputs: no named parameters.
genlayer_plan_contract_actionPlan Contract ActionARead-onlyIdempotent
Build a schema-validated execution plan for deploy, read, or write contract actions.
Inputs: action (required), args, code, from, +5 more.
genlayer_plan_contract_workflowPlan Contract WorkflowARead-onlyIdempotent
Build a multi-phase GenLayer contract workflow covering deploy, wait, snapshot, first read/write, and diagnosis.
Inputs: code, address, contractPath.
genlayer_probe_endpoint_capabilitiesProbe Endpoint CapabilitiesARead-onlyIdempotent
Probe the configured GenLayer deployment and report which health, RPC, sync, and debug surfaces are actually exposed.
Inputs: no named parameters.
genlayer_raw_rpcCall GenLayer RPC MethodCIdempotent
Call a GenLayer JSON-RPC method directly against the configured endpoint.
Inputs: method (required), params.
genlayer_read_docRead GenLayer DocBRead-onlyIdempotent
Read a specific GenLayer documentation section by slug, path, title, or fuzzy query.
Inputs: section (required), maxChars.
genlayer_refresh_docsRefresh GenLayer DocsAIdempotent
Force-refresh the cached GenLayer documentation bundle from the configured source.
Inputs: no named parameters.
genlayer_run_contract_reportRun Contract ReportBRead-onlyIdempotent
Orchestrate network context, contract snapshot, interface summary, workflow plan, and default action plans into one contract report.
Inputs: address (required).
genlayer_run_transaction_reportRun Transaction ReportARead-onlyIdempotent
Orchestrate waiting, inspection, status explanation, optional trace lookup, and optional contract snapshot into one transaction report.
Inputs: txId (required), wait, address, timestamp, +3 more.
genlayer_scaffold_contractScaffold Intelligent ContractARead-onlyIdempotent
Generate a working starter GenLayer intelligent contract for a chosen template. The output has the runner header pinned and avoids the common deploy-killers.
Inputs: template (required), name.
genlayer_scaffold_testScaffold Direct-Mode TestARead-onlyIdempotent
Generate a fast in-memory direct-mode test (genlayer-test) for a contract template. Uses the real fixtures (direct_vm, direct_deploy, direct_alice) and mocks web/LLM calls.
Inputs: template (required), name.
genlayer_search_docsSearch GenLayer DocsBRead-onlyIdempotent
Search the GenLayer documentation bundle and return the most relevant sections.
Inputs: query (required), limit.
genlayer_search_examplesSearch GenLayer ExamplesARead-onlyIdempotent
Search GenLayer documentation sections that contain code blocks, commands, SDK usage, or configuration examples.
Inputs: query (required), limit.
genlayer_start_workflow_sessionStart Workflow SessionB
Create a persisted GenLayer workflow session from a generated contract workflow plan.
Inputs: code, goal, notes, address, +1 more.
genlayer_submit_raw_transactionSubmit Raw TransactionA
Submit a signed GenLayer or Ethereum-compatible raw transaction through eth_sendRawTransaction.
Inputs: rawTransaction (required).
genlayer_syncingCheck GenLayer Sync StatusBRead-onlyIdempotent
Call the configured GenLayer RPC endpoint gen_syncing method.
Inputs: no named parameters.
genlayer_trace_transactionTrace GenLayer TransactionARead-onlyIdempotent
Call gen_dbg_traceTransaction for a transaction hash when the target node exposes debug methods.
Inputs: txID (required), round.
genlayer_update_workflow_stepUpdate Workflow StepAIdempotent
Mark a specific workflow session step as completed or pending.
Inputs: sessionId (required), stepIndex (required), phaseIndex (required), completed.
genlayer_wait_for_transactionWait For TransactionA
Poll GenLayer transaction status until accepted or finalized, then return the combined inspection payload.
Inputs: txId (required), timestamp, intervalMs, maxAttempts, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 46 tools
Most tools have distinct purposes, but there is some overlap among transaction-related tools (e.g., inspect, status, receipt, explain) and contract state retrieval tools (state, code, snapshot, schema). This could cause an agent to select the wrong tool without careful reading.
All 46 tools follow a consistent 'genlayer_verb_noun' pattern with snake_case. The verb and noun are always clearly separated, making the tool set predictable and easy to navigate.
With 46 tools, the surface is very large. While the scope covers many aspects of GenLayer development, the count exceeds the recommended 25+ threshold for 'too many', potentially overwhelming agents and increasing selection errors.
The tool set thoroughly covers the GenLayer lifecycle: scaffolding, linting, testing, workflow planning, contract deployment/interaction, network diagnostics, documentation retrieval, and transaction analysis. No obvious gaps are present.
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
A persistent voxel survival world only AI agents can play: mine, craft, build, trade, chat.
Related MCP Servers
- FlicenseBqualityDmaintenanceMCP server for AI agents to work with GenLayer projects, providing tools to run GenLayer CLI, lint contracts, and deploy contracts with automatic private key handling.47 npm1-
- AlicenseAqualityDmaintenanceA comprehensive MCP server for generating sophisticated GenLayer Intelligent Contracts with AI-native blockchain capabilities.168 npm7MIT
- AlicenseAqualityBmaintenanceA local-first MCP server that gives AI coding agents persistent memory and controlled commands. Features a git-backed markdown knowledge vault with FTS5 search, surgical section edits, token-aware context budgeting, and a sandboxed command engine with human approval gates. Works with Claude Code, Cursor, Copilot, Gemini, and more.62601 npm1Apache 2.0
- AlicenseAqualityCmaintenanceLocal-first MCP server that gives any AI coding agent per-project memory, workflow intelligence, and always-on, lossless token & context optimization.3731 npm6MIT