MCP ExplorerExplorer

Lukso Mcp Schemas

@a6b8on 9 months ago
1 MIT
FreeCommunity
AI Systems
LUKSO-MCP-Schemas is a community-driven repository that uses the FlowMCP framework to structure and expose APIs from LUKSO Blockchain projects as AI-friendly schema files accessible across multiple interfaces.

Overview

What is Lukso Mcp Schemas

LUKSO-MCP-Schemas is a community-driven repository that provides schema files for projects built on the LUKSO Blockchain. It utilizes the FlowMCP framework to structure and expose APIs in a manner that is accessible and AI-friendly across various interfaces.

Use cases

Use cases include building chatbots that can interact with LUKSO projects, automating data retrieval from the blockchain, and creating applications that require seamless access to LUKSO APIs for profiles, NFTs, and more.

How to use

To use LUKSO-MCP-Schemas, developers can interact with the provided schemas through REST APIs, Node.js modules, or libraries like ethers.js and web3.js. This allows for easy integration with AI systems and automation pipelines.

Key features

Key features include the normalization of APIs for easier access, support for multiple interaction methods (REST, Node.js, ethers.js/web3.js), and a variety of available routes for different categories such as profiles, addresses, blocks, and NFTs.

Where to use

LUKSO-MCP-Schemas can be used in various fields including blockchain development, AI integration, and automation of interactions with LUKSO-based projects, making it suitable for developers, data scientists, and businesses looking to leverage blockchain technology.

Content

LUKSO-MCP-Schemas

LUKSO-MCP-Schemas is a community-driven repository that collects and provides schema files for projects built on the LUKSO Blockchain. It leverages the FlowMCP framework to structure and expose project APIs in a way that is AI-friendly and accessible across multiple interfaces.


🎯 Purpose

The goal of this project is to simplify interactions with LUKSO-based projects for AI systems. By using FlowMCP schemas, APIs are normalized and made accessible via text-based interfaces like chatbots, CustomGPTs, or automation pipelines.


🛠 Supported Technologies

Schemas in this repository allow API interaction through:

  • REST APIs
  • Node.js modules
  • ethers.js / web3.js

📚 Available Routes

Below is a list of currently available schemas and their exposed routes:

Namespace # Routes Category Route Names (Excerpt)
luksoNetwork 3 Profiles readProfileData, fetchProfileMetadata, getUniversalProfile
luksoNetwork 12 Addresses listAddresses, getAddress, getAddressCounters, …
luksoNetwork 4 Blocks getBlocks, getBlockById, getBlockTransactions, getFinalized
luksoNetwork 2 Explorer Meta getLuksoExplorerSchema, fectchLuksoExplorer
luksoNetwork 2 Explorer Homepage getMainPageTransactions, getMainPageBlocks
luksoNetwork 7 NFTs getNFTsByAddress, getNFTCollectionsByAddress, getNFTById, …
luksoNetwork 2 Search search, searchRedirect
luksoNetwork 4 Smart Contracts listcontracts, getabi, getsourcecode, getcontractmetadata
luksoNetwork 3 Analytics getStats, getTransactionChart, getMarketChart
luksoNetwork 5 Tokens listTokens, getTokenByAddress, getTokenTransfers, …
luksoNetwork 7 Transactions getTransactions, getTransactionByHash, getTokenTransfersByHash, …
profilejump 5 Aggregated Profiles prices, hotProfiles, tokensList, profilesList, tokenDetails

🔍 This list is continually evolving. Contributions are encouraged to extend this overview with new projects and categories.


🧩 What Is a Schema?

A schema is a structured description of an API or blockchain functionality within a LUKSO project. It contains:

  • Route definitions (GET, POST)
  • Validated parameters (via Zod)
  • Test cases
  • Pre/Post modifiers for data processing
  • Metadata for grouping and filtering

🔍 Complex queries are supported — including dynamic routes, input transformations, or fully custom execution logic using modifiers.execute. This makes it possible to support advanced use cases like wallet analysis, on-chain relationships, or token history tracking.

See the FlowMCP GitHub Repository for more information and usage examples.


⚡ Quickstart

To use this repository with Claude, follow these steps:

  1. Clone the repository:
   git clone https://github.com/a6b8/lukso-mcp-schemas.git
   cd lukso-mcp-schemas
  1. Install dependencies (if required by your schema files):
   npm install
  1. Connect to Claude with the following configuration:

    In your Claude config file (e.g. claude.config.json):

{
  "globalShortcut": "",
  "mcpServers": {
    "LUKSO-MCP": {
      "command": "node",
      "args": [
        "./path/to/your/lukso-mcp.mjs",
        "--launched-by=claude",
        "--includeNamespaces=",
        "--excludeNamespaces=",
        "--activateTags="
      ],
      "env": {}
    }
  }
}
  1. Run Claude with this configuration to start interacting with the schemas.

🤖 AI Integration

Thanks to FlowMCP, AIs like ChatGPT or Claude can interact with these APIs using a standardized structure. This allows them to select appropriate tools from a shared schema pool, simplifying even complex blockchain queries.

You can use the interactive Schema Generator 1.2 to create schemas quickly — just copy and paste.


💡 Contributions Welcome!

Are you building something on the LUKSO Blockchain? Submit your schema and make your project AI-compatible!

  1. Fork this repository.
  2. Add your schema to /schemas/version/<your_project>.mjs.
  3. Submit a pull request.

🔗 Related Resources


📜 License

This project is licensed under the MIT License. Contributions are welcome!

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers