starknet-mcp

MCP.Pizza Chef: AbdelStark

Starknet MCP Server is a TypeScript-based Model Context Protocol server that allows AI models to retrieve real-time data from the Starknet blockchain, such as the latest block information. It facilitates seamless integration of blockchain context into AI workflows, with planned features to interact with smart contracts. Designed for Node.js environments, it supports secure, structured access to Starknet data for enhanced AI-driven applications.

Use This MCP server To

Retrieve the latest block data from Starknet blockchain Provide real-time Starknet blockchain context to AI models Enable AI-driven analysis of Starknet blockchain state Integrate Starknet data into AI-enhanced decentralized app workflows Facilitate smart contract interaction via future MCP tools Support blockchain monitoring and alerting through AI models

README

🌐 Starknet MCP Server

A Model Context Protocol (MCP) server that enables AI models to interact with Starknet.

smithery badge TypeScript MCP Starknet

πŸš€ Features

  • πŸ“ Get the latest block from Starknet

πŸ‘·β€β™‚οΈ TODOs

  • Add tools to be able to interact with smart contracts on Starknet

πŸ“‹ Prerequisites

  • Node.js 18+

πŸ› οΈ Installation

Installing via Smithery

To install Starknet MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AbdelStark/starknet-mcp --client claude

Manual Installation

  1. Clone the repository:
git clone https://github.com/AbdelStark/starknet-mcp
cd starknet-mcp
  1. Install dependencies:
npm install
  1. Create a .env file:

πŸ’‘ You can copy the .env.example file and modify it as needed.

# Log level (debug, info, warn, error)
LOG_LEVEL=debug
# Node environment (development, production)
NODE_ENV=development
# Server mode (stdio or sse)
SERVER_MODE=sse
# Port for SSE mode
PORT=9000
# Starknet RPC URL
STAKNET_RPC_URL=https://...

🚦 Usage

Starting the Server

# Development mode with hot reload
npm run dev

# Production mode
npm start

Available Tools

get_block

Gets the latest block from the Starknet blockchain.

Example input:

{
  "blockNumber": 1234567890
}

πŸ”§ Development

Project Structure

starknet-mcp/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ index.ts        # Main server entry point
β”‚   β”œβ”€β”€ types.ts        # TypeScript type definitions
β”œβ”€β”€ .env               # Environment configuration
└── tsconfig.json     # TypeScript configuration

Running Tests

npm test

🀝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ”— Resources

πŸ“¬ Contact

Feel free to follow me if you'd like, using my public key:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or just scan this QR code to find me:

Starknet Public Key QR Code

starknet-mcp FAQ

How do I install the Starknet MCP Server?
You can install it via Smithery or manually using Node.js 18+ with npm or yarn.
What blockchain data can this MCP server provide?
Currently, it provides the latest block data from Starknet, with plans to support smart contract interactions.
Is the Starknet MCP Server compatible with multiple LLM providers?
Yes, it is designed to work with any MCP-compatible LLM, including OpenAI, Claude, and Gemini.
What are the prerequisites for running this MCP server?
Node.js version 18 or higher is required to run the Starknet MCP Server.
Can this server interact with Starknet smart contracts now?
Not yet, but smart contract interaction tools are planned for future releases.
How does this MCP server enhance AI model capabilities?
It feeds real-time blockchain context into AI models, enabling informed decision-making and blockchain-aware workflows.
Where can I find the source code and documentation?
The source code and documentation are available on GitHub under the repository 'starknet-mcp'.