
## Generate AI Agents for building your Blockchain

Telescope isn’t just a new tool — it’s already powering some of the largest production blockchains in the world, including **Osmosis**, **dYdX**, and the **Cosmos Hub**. Every week, projects using our stack ship to production with confidence, backed by over **7.6 million total downloads** and over **320,000 monthly installs** across the [telescope packages](https://github.com/hyperweb-io/telescope/tree/main/packages).

What makes Telescope powerful is what it abstracts: encoding logic like Amino, gRPC, or Protobuf. We handle complex client generation, ledger hardware wallet support, and RPC bindings so developers can focus on building great apps, not struggling with low-level wire formats.

With [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server generation, we’re taking that ease one step further — letting you generate AI agents that can build on your chain.

Telescope just made it dramatically easier to bring AI into your blockchain workflow.

By enabling MCP, Telescope empowers you to create a companion AI integration layer alongside your TypeScript blockchain client. This turns your blockchain into an environment where AI agents can understand, navigate, and build on your protocol with context-aware tooling.

---

## What is MCP?

The **Model Context Protocol (MCP)** is a new standard that allows AI assistants (like Claude, Cursor, or ChatGPT) to safely and consistently interact with your tools, codebases, and APIs. Think of it as the missing link between your code and an AI that can help you write, test, and understand it.

---

## From Static Codegen to Autonomous Collaboration

Traditional code generators output static files. With Telescope’s MCP server integration, you unlock something much more powerful: a full AI-compatible environment tailored to your blockchain. The generated MCP server gives AI agents the ability to:

- Understand your blockchain's APIs, data types, and logic
- Learn from curated, production-grade examples
- Follow best practices around security and architecture
- Interact dynamically through a smart tool that helps them compose code

It’s like giving your blockchain its own on-call engineer who speaks TypeScript and understands your protocol end-to-end.

---

## What Can AI Agents Build with It?

The MCP server exposes a high-level capability that enables AI agents to generate custom blockchain features on demand. Here are a few categories of functionality that agents can help build:

### Queries

- Wallet balance fetchers
- Staking positions and rewards
- Governance proposals and votes
- Smart contract state and metadata

### Transactions & Actions

- Send tokens
- Stake and un-stake
- Delegate or redelegate
- Vote on proposals
- Execute smart contract calls

### Dashboard Components

- React hooks for live data
- Table components for delegations or proposals
- UI components for user actions (e.g., send, vote, stake)

### Developer Utilities

- Chain configuration and RPC setup helpers
- Type-safe wrappers around your protocol
- CLI command builders or scripts

Agents aren’t limited to pre-defined actions—they dynamically compose functionality by learning from examples and understanding your code structure.

---

## Why This Matters

### Accelerated Development

AI agents can help bootstrap entire features and interfaces within minutes, turning dev workflows into interactive conversations.

### Type-Safe and Secure

The MCP server includes guidance for secure coding practices and full access to TypeScript types, helping agents generate high-quality, safe code.

### Educational for Devs

Even if you don’t fully delegate coding to an AI, the system becomes a valuable teaching tool that helps you or your team understand your own blockchain interfaces faster.

---

## A New Era of Blockchain Development

With MCP server generation, your blockchain client becomes:

- **Understandable** to machines and developers alike
- **Composable** for dynamic function generation
- **Secure** with baked-in best practices
- **Extensible** through structured AI interaction

No more copy-pasting from docs. No more digging through RPC specs. Just say what you want to build—and let your AI agent help implement it.

This is a shift from manual development to collaborative, contextual coding.

---

## Ready to Build? Get Started in 3 Steps

### 1. **Enable MCP Server Generation**

Add MCP server generation to your existing Telescope configuration:

```typescript
import { TelescopeOptions } from '@hyperweb/telescope';

const options: TelescopeOptions = {
	mcpServer: {
		enabled: true,
	},
	// ... your existing options
};
```

### 2. **Generate Your AI-Ready Environment**

Run Telescope as usual. You'll now get a complete MCP server alongside your TypeScript client:

```bash
# Your blockchain client + AI agent server
my-chain/          # Your existing generated client
my-chain-mcp/      # 🆕 Your new AI agent server
├── src/
│   ├── my-chain/         # 📚 Telescope generated code (primary reference, excluded from build)
│   ├── my-chain-examples/ # 📖 Production examples (excluded from build)
│   ├── prompts/              # 🤖 Agent instruction files
│   └── index.ts              # MCP server entry point
├── package.json              # Ready-to-publish npm package
├── tsconfig.json             # TypeScript configuration
└── README.md                 # Usage instructions
```

### 3. **Connect with AI Agents**

Build your MCP server and connect it with Claude, Cursor, or any MCP-compatible AI:

```bash
cd my-chain-mcp
npm install
npm run build    # Compiles only the MCP server code (my-chain/ and my-chain-examples/ are excluded)
npm run inspector  # Test your tools interactively if you want
```

Add the MCP server to your AI agent configuration:

```json
{
	"mcpServers": {
		"my-chain-mcp-server": {
			"command": "node",
			"args": ["/absolute-path/my-chain-mcp/dist/index.js"]
		}
	}
}
```

**What you get instantly:**

- Function generator tool for using your project functions
- Production examples as reference patterns for implementation
- Complete TypeScript reference from telescope-generated code
- AI prompts for usage guidelines and best practices

**How it works:**
The MCP server provides a single function generator tool that analyzes your requests and provides step-by-step implementation guidance using your codebase as reference. Your AI agent will understand your protocol's types, patterns, and architecture from day one.

📚 **Full Documentation:** [docs.hyperweb.io/telescope/developing/mcp-integration](https://docs.hyperweb.io/telescope/developing/mcp-integration)

---

## Extending Examples

You can enhance the AI agent's knowledge by adding more examples to the `my-chain-examples/` directory:

```bash
cd my-chain-mcp/src/my-chain-examples
# Add your custom implementation examples
```

**Benefits of adding examples:**

- **Better guidance**: AI agents will have more patterns to reference
- **Custom use cases**: Add examples specific to your project needs
- **Improved accuracy**: More examples help the function generator provide better recommendations

The function generator tool automatically scans the `my-chain-examples/` directory, so new examples will be available immediately for AI agents to reference.

Please note that the examples you provide don’t need to be perfect. The MCP server will guide the agent to learn the underlying logic and patterns in the code rather than simply copying and pasting. By combining its existing knowledge, it will deliver the best possible result.

## Important Migration Note

Telescope now lives under the **@hyperweb** scope — it was previously published under @cosmology. If you're already using Telescope, make sure to [upgrade to @hyperweb/telescope](https://www.npmjs.com/package/@hyperweb/telescope) to unlock the new MCP server capabilities and future enhancements.

For now, start imagining what it means to build on a blockchain that can talk back—and help build itself.


Telescope now generates MCP servers that let AI agents understand and build on your blockchain. Create type-safe queries, transactions, and components with AI collaboration.

Generate an AI Agent for your Blockchain with Telescope