@andrewkimjoseph/celina 0.2.6 → 0.2.8

package/README.md

@@ -106,7 +106,7 @@ Never commit private keys. Use env vars only.
 
 Celina is an **MCP tool server**. A local LLM stack needs an **MCP client** that can connect to Celina and pass tool definitions to a model that supports **function / tool calling**.
 
-Read-only tools (balances, blocks, GoodDollar status, etc.) work out of the box. For local write tools (`send_token`, `estimate_send`), set `CELO_PRIVATE_KEY` in the MCP server `env` block (stdio) or use the [hosted encryption flow](#write-tools-hosted-mode) (HTTP).
+Read-only tools (balances, blocks, GoodDollar status, etc.) work out of the box. For local write tools (`send_token`, `estimate_send`, `execute_mento_fx`), set `CELO_PRIVATE_KEY` in the MCP server `env` block (stdio) or use the [hosted encryption flow](#write-tools-hosted-mode) (HTTP).
 
 ### LM Studio (0.3.17+)
 
@@ -196,7 +196,7 @@ npm run inspect
 
 ## Write tools (hosted mode)
 
-Write tools (`send_token`, `estimate_send`) accept an RSA-encrypted private key per request — never plaintext.
+Write tools (`send_token`, `estimate_send`, `execute_mento_fx`) accept an RSA-encrypted private key per request — never plaintext.
 
 ### Flow
 
@@ -257,6 +257,11 @@ Token symbols are resolved case-insensitively. Legacy aliases `cUSD` and `cEUR`
 | `get_wallet_encryption_public_key` | read | RSA public key for encrypting private keys |
 | `estimate_send` | read* | Gas estimate (*needs encrypted or env key) |
 | `send_token` | write | Send CELO or ERC-20 |
+| `get_mento_fx_quote` | read | Mento FX expected output (no wallet) |
+| `estimate_mento_fx` | read* | Mento FX gas estimate (*needs encrypted or env key) |
+| `execute_mento_fx` | write | Execute Mento FX conversion |
+| `supply_aave_usdt` | write | Supply USDT to Aave V3 on Celo |
+| `withdraw_aave_usdt` | write | Withdraw USDT from Aave V3 on Celo |
 
 ## Adding a new tool
 
@@ -282,8 +287,8 @@ No changes to `src/index.ts` or server bootstrap required.
 
 ## Roadmap
 
-- [ ] Mento / DEX swap routing (`execute_swap`)
-- [ ] Aave lending tools
+- [x] Mento FX routing (`get_mento_fx_quote`, `estimate_mento_fx`, `execute_mento_fx`)
+- [x] Aave lending tools (`supply_aave_usdt`, `withdraw_aave_usdt`)
 - [ ] Self proof verification (`ai.self.xyz`)
 - [ ] Self Agent ID check
 

package/build/clients/aave-client.d.ts

@@ -0,0 +1,2 @@
+import { AaveClient } from "@aave/client";
+export declare const aaveClient: AaveClient;

package/build/clients/aave-client.js

@@ -0,0 +1,3 @@
+import { AaveClient } from "@aave/client";
+export const aaveClient = AaveClient.create();
+//# sourceMappingURL=aave-client.js.map

package/build/clients/aave-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-client.js","sourceRoot":"","sources":["../../src/clients/aave-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC"}

package/build/clients/aave-send.d.ts

@@ -0,0 +1,7 @@
+import type { TransactionExecutionResult } from "@aave/client";
+import type { ExecutionPlan } from "@aave/graphql";
+import type { PublicClient, WalletClient } from "viem";
+export declare function sendExecutionPlan(wallet: WalletClient, publicClient: PublicClient, plan: ExecutionPlan): Promise<{
+    result: TransactionExecutionResult;
+    approvalHash?: `0x${string}`;
+}>;

package/build/clients/aave-send.js

@@ -0,0 +1,49 @@
+import { txHash } from "@aave/types";
+function toTxParams(request) {
+    return {
+        to: request.to,
+        data: request.data,
+        value: BigInt(request.value),
+    };
+}
+async function sendTransactionRequest(wallet, publicClient, request) {
+    const account = wallet.account;
+    if (!account) {
+        throw new Error("Wallet account unavailable.");
+    }
+    const chain = publicClient.chain;
+    if (!chain) {
+        throw new Error("Chain configuration missing.");
+    }
+    const hash = await wallet.sendTransaction({
+        chain,
+        account,
+        ...toTxParams(request),
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash });
+    if (receipt.status === "reverted") {
+        throw new Error(`Transaction reverted: ${hash}`);
+    }
+    return {
+        txHash: txHash(hash),
+        operation: request.operation ?? null,
+    };
+}
+export async function sendExecutionPlan(wallet, publicClient, plan) {
+    switch (plan.__typename) {
+        case "InsufficientBalanceError":
+            throw new Error(`Insufficient balance: required ${plan.required.value}, available ${plan.available.value}.`);
+        case "TransactionRequest": {
+            const result = await sendTransactionRequest(wallet, publicClient, plan);
+            return { result };
+        }
+        case "ApprovalRequired": {
+            const approval = await sendTransactionRequest(wallet, publicClient, plan.approval);
+            const result = await sendTransactionRequest(wallet, publicClient, plan.originalTransaction);
+            return { result, approvalHash: approval.txHash };
+        }
+        default:
+            throw new Error(`Unknown execution plan: ${plan.__typename}`);
+    }
+}
+//# sourceMappingURL=aave-send.js.map

package/build/clients/aave-send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-send.js","sourceRoot":"","sources":["../../src/clients/aave-send.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,SAAS,UAAU,CAAC,OAA2B;IAC7C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAmB;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAqB;QACnC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,MAAoB,EACpB,YAA0B,EAC1B,OAA2B;IAE3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QACxC,KAAK;QACL,OAAO;QACP,GAAG,UAAU,CAAC,OAAO,CAAC;KACvB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,YAA0B,EAC1B,IAAmB;IAEnB,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,KAAK,0BAA0B;YAC7B,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,QAAQ,CAAC,KAAK,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAC5F,CAAC;QACJ,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;YACxE,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAC3C,MAAM,EACN,YAAY,EACZ,IAAI,CAAC,QAAQ,CACd,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,MAAM,EACN,YAAY,EACZ,IAAI,CAAC,mBAAmB,CACzB,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAuB,EAAE,CAAC;QACpE,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CACb,2BAA4B,IAA+B,CAAC,UAAU,EAAE,CACzE,CAAC;IACN,CAAC;AACH,CAAC"}

package/build/clients/mento-sdk.d.ts

@@ -0,0 +1,2 @@
+export declare const Mento: typeof import("@mento-protocol/mento-sdk").Mento, ChainId: typeof import("@mento-protocol/mento-sdk").ChainId, deadlineFromMinutes: typeof import("@mento-protocol/mento-sdk").deadlineFromMinutes, RouteNotFoundError: typeof import("@mento-protocol/mento-sdk").RouteNotFoundError, FXMarketClosedError: typeof import("@mento-protocol/mento-sdk").FXMarketClosedError;
+export type { CallParams } from "@mento-protocol/mento-sdk";

package/build/clients/mento-sdk.js

@@ -0,0 +1,9 @@
+import { createRequire } from "node:module";
+/**
+ * @mento-protocol/mento-sdk's ESM build omits .js extensions on internal imports.
+ * Load the CJS entry via createRequire until upstream fixes exports.
+ */
+const require = createRequire(import.meta.url);
+const mentoSdk = require("@mento-protocol/mento-sdk");
+export const { Mento, ChainId, deadlineFromMinutes, RouteNotFoundError, FXMarketClosedError, } = mentoSdk;
+//# sourceMappingURL=mento-sdk.js.map

package/build/clients/mento-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mento-sdk.js","sourceRoot":"","sources":["../../src/clients/mento-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,2BAA2B,CAA+C,CAAC;AAEpG,MAAM,CAAC,MAAM,EACX,KAAK,EACL,OAAO,EACP,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,GAAG,QAAQ,CAAC"}

package/build/config/aave.d.ts

@@ -0,0 +1,5 @@
+/** Aave V3 on Celo mainnet — from bgd-labs/aave-address-book AaveV3Celo */
+export declare const AAVE_POOL: "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+export declare const AAVE_USDT: "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e";
+export declare const AAVE_USDT_A_TOKEN: "0xDeE98402A302e4D707fB9bf2bac66fAEEc31e8Df";
+export declare const AAVE_CHAIN_ID = 42220;

package/build/config/aave.js

@@ -0,0 +1,6 @@
+/** Aave V3 on Celo mainnet — from bgd-labs/aave-address-book AaveV3Celo */
+export const AAVE_POOL = "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+export const AAVE_USDT = "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e";
+export const AAVE_USDT_A_TOKEN = "0xDeE98402A302e4D707fB9bf2bac66fAEEc31e8Df";
+export const AAVE_CHAIN_ID = 42220;
+//# sourceMappingURL=aave.js.map

package/build/config/aave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave.js","sourceRoot":"","sources":["../../src/config/aave.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,4CAAqD,CAAC;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,4CAAqD,CAAC;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAC5B,4CAAqD,CAAC;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC"}

package/build/config/chains.d.ts

@@ -912,6 +912,8 @@ export declare const CHAIN: {
     verifyHash?: ((client: import("viem").Client, parameters: import("viem").VerifyHashActionParameters) => Promise<import("viem").VerifyHashActionReturnType>) | undefined;
 };
 export declare const DEFAULT_RPC_URL = "https://forno.celo.org";
+/** Mento collateral address for native CELO (used by @mento-protocol/mento-sdk). */
+export declare const MENTO_CELO_ADDRESS: "0x471EcE3750Da237f93B8E339c536989b8978a438";
 export type KnownToken = {
     symbol: string;
     address: `0x${string}` | "native";
@@ -929,4 +931,5 @@ export type Stablecoin = KnownToken & {
 export declare const STABLECOINS: Stablecoin[];
 export declare const KNOWN_TOKEN_SYMBOLS: string[];
 export declare function findKnownToken(token: string): KnownToken | undefined;
+export declare function toMentoTokenAddress(address: `0x${string}` | "native"): `0x${string}`;
 export declare function resolveStablecoins(symbols?: string[]): Stablecoin[];

package/build/config/chains.js

@@ -1,6 +1,8 @@
 import { celo } from "viem/chains";
 export const CHAIN = celo;
 export const DEFAULT_RPC_URL = "https://forno.celo.org";
+/** Mento collateral address for native CELO (used by @mento-protocol/mento-sdk). */
+export const MENTO_CELO_ADDRESS = "0x471EcE3750Da237f93B8E339c536989b8978a438";
 export const KNOWN_TOKENS = [
     {
         symbol: "CELO",
@@ -219,6 +221,12 @@ export function findKnownToken(token) {
     return KNOWN_TOKENS.find((entry) => tokenMatchesInput(entry, normalized, upper) ||
         (upper === "NATIVE" && entry.address === "native"));
 }
+export function toMentoTokenAddress(address) {
+    if (address === "native") {
+        return MENTO_CELO_ADDRESS;
+    }
+    return address;
+}
 export function resolveStablecoins(symbols) {
     if (!symbols?.length) {
         return STABLECOINS;

package/build/config/chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../src/config/chains.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../src/config/chains.ts"],"names":[],"mappings":"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"}

package/build/config/load-env.d.ts

@@ -0,0 +1 @@
+export {};

package/build/config/load-env.js

@@ -0,0 +1,4 @@
+import { config } from "dotenv";
+// quiet: true — dotenv v17 logs to stdout by default, which breaks MCP stdio JSON
+config({ quiet: true });
+//# sourceMappingURL=load-env.js.map

package/build/config/load-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/config/load-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,kFAAkF;AAClF,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC"}

package/build/context/app-context.d.ts

@@ -3,7 +3,9 @@ import { BlockchainService } from "../services/blockchain.service.js";
 import { AccountService } from "../services/account.service.js";
 import { TokenService } from "../services/token.service.js";
 import { TransactionService } from "../services/transaction.service.js";
+import { MentoFxService } from "../services/mento-fx.service.js";
 import { GoodDollarService } from "../services/gooddollar.service.js";
+import { AaveService } from "../services/aave.service.js";
 export interface AppContext {
     config: {
         hasWallet: boolean;
@@ -13,6 +15,8 @@ export interface AppContext {
     account: AccountService;
     token: TokenService;
     transaction: TransactionService;
+    mentoFx: MentoFxService;
     gooddollar: GoodDollarService;
+    aave: AaveService;
 }
 export declare function createAppContext(clientFactory: CeloClientFactory, walletAddress?: `0x${string}`): AppContext;

package/build/context/app-context.js

@@ -2,7 +2,9 @@ import { BlockchainService } from "../services/blockchain.service.js";
 import { AccountService } from "../services/account.service.js";
 import { TokenService } from "../services/token.service.js";
 import { TransactionService } from "../services/transaction.service.js";
+import { MentoFxService } from "../services/mento-fx.service.js";
 import { GoodDollarService } from "../services/gooddollar.service.js";
+import { AaveService } from "../services/aave.service.js";
 export function createAppContext(clientFactory, walletAddress) {
     return {
         config: {
@@ -13,7 +15,9 @@ export function createAppContext(clientFactory, walletAddress) {
         account: new AccountService(clientFactory),
         token: new TokenService(clientFactory),
         transaction: new TransactionService(clientFactory),
+        mentoFx: new MentoFxService(clientFactory),
         gooddollar: new GoodDollarService(clientFactory),
+        aave: new AaveService(clientFactory),
     };
 }
 //# sourceMappingURL=app-context.js.map

package/build/context/app-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AActE,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,aAA6B;IAE7B,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;SACd;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;KACjD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAgB1D,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,aAA6B;IAE7B,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;SACd;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/build/http.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+import "./config/load-env.js";

package/build/http.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import "./config/load-env.js";
 import { app } from "./server/create-http-app.js";
 const PORT = parseInt(process.env.PORT || "10000", 10);
 if (!process.env.WALLET_ENCRYPTION_PRIVATE_KEY) {

package/build/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAElD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AAEvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;IAC/C,OAAO,CAAC,IAAI,CACV,yGAAyG,CAC1G,CAAC;AACJ,CAAC;AAED,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;IAC/B,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAElD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AAEvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;IAC/C,OAAO,CAAC,IAAI,CACV,yGAAyG,CAC1G,CAAC;AACJ,CAAC;AAED,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;IAC/B,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/index.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+import "./config/load-env.js";

package/build/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import "./config/load-env.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "./server/create-server.js";
 async function main() {

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/server/instructions.js

@@ -4,11 +4,14 @@ You are connected to Celina, the Celo MCP server (mainnet only).
 Guidelines:
 - Prefer read-only tools (get_*) before any write operation.
 - Always call estimate_send before send_token when possible.
+- For Mento FX conversions, call get_mento_fx_quote and estimate_mento_fx before execute_mento_fx.
 - Write tools require CELO_PRIVATE_KEY in the server environment.
 - Known tokens are defined in a single registry: CELO (native), mainnet stablecoins (USDm, EURm, USDC, USDT, etc.), and GoodDollar.
 - Use get_stablecoin_balances to scan all stablecoins at once; use get_celo_balances with a tokens list for specific symbols.
 - Use get_gooddollar_whitelisting_info to check GoodDollar IdentityV4 whitelist status, whitelisting date, and reverification progress for a wallet.
+- Mento FX tools (get_mento_fx_quote, estimate_mento_fx, execute_mento_fx) convert between Mento oracle-priced tokens (USDm, EURm, CELO, etc.). They are unavailable when the Mento FX market is closed.
+- Aave tools (supply_aave_usdt, withdraw_aave_usdt) supply and withdraw USDT on Aave V3 Celo. Use get_celo_balances with tokens ["USDT"] before supplying; use withdrawMax on withdraw to redeem the full supplied balance.
 
-Future tools (add as new modules in src/tools/): lend on Aave, Self verify, Self Agent ID check.
+Future tools (add as new modules in src/tools/): Self verify, Self Agent ID check.
 `.trim();
 //# sourceMappingURL=instructions.js.map

package/build/server/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;CAYlC,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;CAelC,CAAC,IAAI,EAAE,CAAC"}

package/build/services/aave.service.d.ts

@@ -0,0 +1,28 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+export declare class AaveService {
+    private readonly clientFactory;
+    private readonly tokenService;
+    constructor(clientFactory: CeloClientFactory);
+    private resolveClients;
+    private formatAaveError;
+    private assertUsdtBalance;
+    private assertSuppliedBalance;
+    supplyUsdt(amount: string, encryptedPrivateKey?: string): Promise<{
+        from: `0x${string}`;
+        amount: string;
+        token: string;
+        market: "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+        hash: import("@aave/types").TxHash;
+        approvalHash: `0x${string}` | undefined;
+        operation: string;
+    }>;
+    withdrawUsdt(amount: string | undefined, encryptedPrivateKey?: string, withdrawMax?: boolean): Promise<{
+        from: `0x${string}`;
+        amount: string;
+        token: string;
+        market: "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+        hash: import("@aave/types").TxHash;
+        operation: string;
+        withdrawMax: boolean;
+    }>;
+}

package/build/services/aave.service.js

@@ -0,0 +1,144 @@
+import { supply, withdraw } from "@aave/client/actions";
+import { bigDecimal, chainId, evmAddress } from "@aave/types";
+import { erc20Abi } from "viem";
+import { aaveClient } from "../clients/aave-client.js";
+import { sendExecutionPlan } from "../clients/aave-send.js";
+import { AAVE_CHAIN_ID, AAVE_POOL, AAVE_USDT, AAVE_USDT_A_TOKEN, } from "../config/aave.js";
+import { decryptPrivateKey } from "../crypto/wallet-key-crypto.js";
+import { TokenService } from "./token.service.js";
+export class AaveService {
+    clientFactory;
+    tokenService;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+        this.tokenService = new TokenService(clientFactory);
+    }
+    resolveClients(encryptedPrivateKey) {
+        if (encryptedPrivateKey) {
+            const privateKey = decryptPrivateKey(encryptedPrivateKey);
+            return this.clientFactory.getClientsForAccount(privateKey);
+        }
+        const clients = this.clientFactory.getClients();
+        if (!clients.wallet || !clients.accountAddress) {
+            throw new Error("No wallet configured. Provide encryptedPrivateKey (encrypt with get_wallet_encryption_public_key) or set CELO_PRIVATE_KEY for local mode.");
+        }
+        return clients;
+    }
+    formatAaveError(error) {
+        if (error && typeof error === "object" && "name" in error && "message" in error) {
+            const named = error;
+            throw new Error(`${named.name}: ${named.message}`);
+        }
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+    async assertUsdtBalance(publicClient, owner, amount) {
+        const usdt = this.tokenService.resolveToken("USDT");
+        const required = this.tokenService.parseAmount(amount, usdt.decimals);
+        const balance = await publicClient.readContract({
+            address: AAVE_USDT,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [owner],
+        });
+        if (balance < required) {
+            throw new Error(`Insufficient USDT balance. Required ${amount} USDT, available ${balance.toString()} raw units.`);
+        }
+    }
+    async assertSuppliedBalance(publicClient, owner, amount) {
+        const usdt = this.tokenService.resolveToken("USDT");
+        const required = this.tokenService.parseAmount(amount, usdt.decimals);
+        const balance = await publicClient.readContract({
+            address: AAVE_USDT_A_TOKEN,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [owner],
+        });
+        if (balance < required) {
+            throw new Error(`Insufficient Aave USDT supply balance. Required ${amount} USDT, available ${balance.toString()} raw aToken units.`);
+        }
+    }
+    async supplyUsdt(amount, encryptedPrivateKey) {
+        const { public: publicClient, wallet, accountAddress: from } = this.resolveClients(encryptedPrivateKey);
+        if (!wallet || !from) {
+            throw new Error("Wallet client unavailable. Provide encryptedPrivateKey or set CELO_PRIVATE_KEY.");
+        }
+        await this.assertUsdtBalance(publicClient, from, amount);
+        const planResult = await supply(aaveClient, {
+            market: evmAddress(AAVE_POOL),
+            amount: {
+                erc20: {
+                    currency: evmAddress(AAVE_USDT),
+                    value: bigDecimal(amount),
+                },
+            },
+            sender: evmAddress(from),
+            chainId: chainId(AAVE_CHAIN_ID),
+        });
+        if (planResult.isErr()) {
+            this.formatAaveError(planResult.error);
+        }
+        const { result, approvalHash } = await sendExecutionPlan(wallet, publicClient, planResult.value);
+        const waitResult = await aaveClient.waitForTransaction(result);
+        if (waitResult.isErr()) {
+            this.formatAaveError(waitResult.error);
+        }
+        return {
+            from,
+            amount,
+            token: "USDT",
+            market: AAVE_POOL,
+            hash: waitResult.value,
+            approvalHash,
+            operation: "SUPPLY",
+        };
+    }
+    async withdrawUsdt(amount, encryptedPrivateKey, withdrawMax) {
+        const { public: publicClient, wallet, accountAddress: from } = this.resolveClients(encryptedPrivateKey);
+        if (!wallet || !from) {
+            throw new Error("Wallet client unavailable. Provide encryptedPrivateKey or set CELO_PRIVATE_KEY.");
+        }
+        if (!withdrawMax && !amount) {
+            throw new Error("Provide amount or set withdrawMax to true.");
+        }
+        if (!withdrawMax && amount) {
+            await this.assertSuppliedBalance(publicClient, from, amount);
+        }
+        const withdrawAmount = withdrawMax
+            ? {
+                erc20: {
+                    currency: evmAddress(AAVE_USDT),
+                    value: { max: true },
+                },
+            }
+            : {
+                erc20: {
+                    currency: evmAddress(AAVE_USDT),
+                    value: { exact: bigDecimal(amount) },
+                },
+            };
+        const planResult = await withdraw(aaveClient, {
+            market: evmAddress(AAVE_POOL),
+            amount: withdrawAmount,
+            sender: evmAddress(from),
+            chainId: chainId(AAVE_CHAIN_ID),
+        });
+        if (planResult.isErr()) {
+            this.formatAaveError(planResult.error);
+        }
+        const { result } = await sendExecutionPlan(wallet, publicClient, planResult.value);
+        const waitResult = await aaveClient.waitForTransaction(result);
+        if (waitResult.isErr()) {
+            this.formatAaveError(waitResult.error);
+        }
+        return {
+            from,
+            amount: withdrawMax ? "max" : amount,
+            token: "USDT",
+            market: AAVE_POOL,
+            hash: waitResult.value,
+            operation: "WITHDRAW",
+            withdrawMax: Boolean(withdrawMax),
+        };
+    }
+}
+//# sourceMappingURL=aave.service.js.map

package/build/services/aave.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave.service.js","sourceRoot":"","sources":["../../src/services/aave.service.ts"],"names":[],"mappings":"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"}

package/build/services/mento-fx.service.d.ts

@@ -0,0 +1,66 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+export interface MentoFxParams {
+    slippageTolerance?: number;
+    deadlineMinutes?: number;
+    recipient?: `0x${string}`;
+    encryptedPrivateKey?: string;
+}
+export declare class MentoFxService {
+    private readonly clientFactory;
+    private readonly tokenService;
+    constructor(clientFactory: CeloClientFactory);
+    private resolveClients;
+    private getMentoClient;
+    private resolveMentoPair;
+    private fxOptions;
+    private formatFxError;
+    private toGasParams;
+    private estimateCallGas;
+    private baseQuoteFields;
+    getFxQuote(tokenIn: string, tokenOut: string, amount: string): Promise<{
+        protocol: "mento_fx";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+    }>;
+    estimateFx(tokenIn: string, tokenOut: string, amount: string, params?: MentoFxParams): Promise<{
+        from: `0x${string}`;
+        recipient: `0x${string}`;
+        amountOutMin: string;
+        approvalNeeded: boolean;
+        approvalGas: string | undefined;
+        fxGas: string;
+        slippageTolerance: number;
+        deadline: string;
+        deadlineMinutes: number;
+        protocol: "mento_fx";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+    }>;
+    executeFx(tokenIn: string, tokenOut: string, amount: string, params?: MentoFxParams): Promise<{
+        from: `0x${string}`;
+        recipient: `0x${string}`;
+        amountOutMin: string;
+        approvalNeeded: boolean;
+        approvalHash: `0x${string}` | undefined;
+        hash: `0x${string}`;
+        status: "success" | "reverted";
+        slippageTolerance: number;
+        deadline: string;
+        deadlineMinutes: number;
+        protocol: "mento_fx";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+    }>;
+}

package/build/services/mento-fx.service.js

@@ -0,0 +1,190 @@
+import { ChainId, deadlineFromMinutes, Mento, RouteNotFoundError, FXMarketClosedError, } from "../clients/mento-sdk.js";
+import { formatUnits } from "viem";
+import { toMentoTokenAddress } from "../config/chains.js";
+import { decryptPrivateKey } from "../crypto/wallet-key-crypto.js";
+import { TokenService } from "./token.service.js";
+const DEFAULT_SLIPPAGE = 0.5;
+const DEFAULT_DEADLINE_MINUTES = 5;
+export class MentoFxService {
+    clientFactory;
+    tokenService;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+        this.tokenService = new TokenService(clientFactory);
+    }
+    resolveClients(encryptedPrivateKey) {
+        if (encryptedPrivateKey) {
+            const privateKey = decryptPrivateKey(encryptedPrivateKey);
+            return this.clientFactory.getClientsForAccount(privateKey);
+        }
+        const clients = this.clientFactory.getClients();
+        if (!clients.wallet || !clients.accountAddress) {
+            throw new Error("No wallet configured. Provide encryptedPrivateKey (encrypt with get_wallet_encryption_public_key) or set CELO_PRIVATE_KEY for local mode.");
+        }
+        return clients;
+    }
+    async getMentoClient(publicClient) {
+        return Mento.create(ChainId.CELO, publicClient);
+    }
+    resolveMentoPair(tokenIn, tokenOut) {
+        const resolvedIn = this.tokenService.resolveToken(tokenIn);
+        const resolvedOut = this.tokenService.resolveToken(tokenOut);
+        return {
+            resolvedIn,
+            resolvedOut,
+            mentoIn: toMentoTokenAddress(resolvedIn.address),
+            mentoOut: toMentoTokenAddress(resolvedOut.address),
+        };
+    }
+    fxOptions(params) {
+        const slippageTolerance = params?.slippageTolerance ?? DEFAULT_SLIPPAGE;
+        const deadlineMinutes = params?.deadlineMinutes ?? DEFAULT_DEADLINE_MINUTES;
+        return {
+            slippageTolerance,
+            deadlineMinutes,
+            deadline: deadlineFromMinutes(deadlineMinutes),
+        };
+    }
+    formatFxError(error, tokenIn, tokenOut) {
+        if (error instanceof RouteNotFoundError) {
+            throw new Error(`No Mento FX route for ${tokenIn} → ${tokenOut}.`);
+        }
+        if (error instanceof FXMarketClosedError) {
+            throw new Error("Mento FX market is currently closed. FX quotes and execution are unavailable until the market reopens.");
+        }
+        if (error instanceof Error && /FXMarketClosed/i.test(error.message)) {
+            throw new Error("Mento FX market is currently closed. FX quotes and execution are unavailable until the market reopens.");
+        }
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+    toGasParams(params) {
+        return {
+            to: params.to,
+            data: params.data,
+            value: BigInt(params.value),
+        };
+    }
+    async estimateCallGas(client, from, params) {
+        const gas = await client.estimateGas({
+            account: from,
+            ...this.toGasParams(params),
+        });
+        return gas.toString();
+    }
+    baseQuoteFields(resolvedIn, resolvedOut, amount, expectedOutWei, routeHops) {
+        return {
+            protocol: "mento_fx",
+            network: "mainnet",
+            tokenIn: resolvedIn.symbol,
+            tokenOut: resolvedOut.symbol,
+            amountIn: amount,
+            expectedOut: formatUnits(expectedOutWei, resolvedOut.decimals),
+            routeHops,
+        };
+    }
+    async getFxQuote(tokenIn, tokenOut, amount) {
+        const { public: client } = this.clientFactory.getClients();
+        const { resolvedIn, resolvedOut, mentoIn, mentoOut } = this.resolveMentoPair(tokenIn, tokenOut);
+        const amountInWei = this.tokenService.parseAmount(amount, resolvedIn.decimals);
+        try {
+            const mento = await this.getMentoClient(client);
+            const [expectedOutWei, route] = await Promise.all([
+                mento.quotes.getAmountOut(mentoIn, mentoOut, amountInWei),
+                mento.routes.findRoute(mentoIn, mentoOut),
+            ]);
+            return this.baseQuoteFields(resolvedIn, resolvedOut, amount, expectedOutWei, route.path.length);
+        }
+        catch (error) {
+            this.formatFxError(error, resolvedIn.symbol, resolvedOut.symbol);
+        }
+    }
+    async estimateFx(tokenIn, tokenOut, amount, params) {
+        const { public: client, accountAddress: from } = this.resolveClients(params?.encryptedPrivateKey);
+        if (!from) {
+            throw new Error("Wallet address unavailable.");
+        }
+        const { resolvedIn, resolvedOut, mentoIn, mentoOut } = this.resolveMentoPair(tokenIn, tokenOut);
+        const recipient = params?.recipient ?? from;
+        const amountInWei = this.tokenService.parseAmount(amount, resolvedIn.decimals);
+        const { slippageTolerance, deadlineMinutes, deadline } = this.fxOptions(params);
+        try {
+            const mento = await this.getMentoClient(client);
+            const { approval, swap } = await mento.swap.buildSwapTransaction(mentoIn, mentoOut, amountInWei, recipient, from, { slippageTolerance, deadline });
+            const [approvalGas, fxGas] = await Promise.all([
+                approval
+                    ? this.estimateCallGas(client, from, approval)
+                    : Promise.resolve(undefined),
+                this.estimateCallGas(client, from, swap.params),
+            ]);
+            return {
+                ...this.baseQuoteFields(resolvedIn, resolvedOut, amount, swap.expectedAmountOut, swap.route.path.length),
+                from,
+                recipient,
+                amountOutMin: formatUnits(swap.amountOutMin, resolvedOut.decimals),
+                approvalNeeded: approval !== null,
+                approvalGas,
+                fxGas,
+                slippageTolerance,
+                deadline: deadline.toString(),
+                deadlineMinutes,
+            };
+        }
+        catch (error) {
+            this.formatFxError(error, resolvedIn.symbol, resolvedOut.symbol);
+        }
+    }
+    async executeFx(tokenIn, tokenOut, amount, params) {
+        const { public: client, wallet, accountAddress: from } = this.resolveClients(params?.encryptedPrivateKey);
+        if (!wallet || !from) {
+            throw new Error("Wallet client unavailable. Provide encryptedPrivateKey or set CELO_PRIVATE_KEY.");
+        }
+        const account = wallet.account;
+        if (!account) {
+            throw new Error("Wallet account unavailable.");
+        }
+        const chain = client.chain;
+        if (!chain) {
+            throw new Error("Chain configuration missing");
+        }
+        const { resolvedIn, resolvedOut, mentoIn, mentoOut } = this.resolveMentoPair(tokenIn, tokenOut);
+        const recipient = params?.recipient ?? from;
+        const amountInWei = this.tokenService.parseAmount(amount, resolvedIn.decimals);
+        const { slippageTolerance, deadlineMinutes, deadline } = this.fxOptions(params);
+        try {
+            const mento = await this.getMentoClient(client);
+            const { approval, swap } = await mento.swap.buildSwapTransaction(mentoIn, mentoOut, amountInWei, recipient, from, { slippageTolerance, deadline });
+            let approvalHash;
+            if (approval) {
+                approvalHash = await wallet.sendTransaction({
+                    chain,
+                    account,
+                    ...this.toGasParams(approval),
+                });
+                await client.waitForTransactionReceipt({ hash: approvalHash });
+            }
+            const hash = await wallet.sendTransaction({
+                chain,
+                account,
+                ...this.toGasParams(swap.params),
+            });
+            const receipt = await client.waitForTransactionReceipt({ hash });
+            return {
+                ...this.baseQuoteFields(resolvedIn, resolvedOut, amount, swap.expectedAmountOut, swap.route.path.length),
+                from,
+                recipient,
+                amountOutMin: formatUnits(swap.amountOutMin, resolvedOut.decimals),
+                approvalNeeded: approval !== null,
+                approvalHash,
+                hash,
+                status: receipt.status,
+                slippageTolerance,
+                deadline: deadline.toString(),
+                deadlineMinutes,
+            };
+        }
+        catch (error) {
+            this.formatFxError(error, resolvedIn.symbol, resolvedOut.symbol);
+        }
+    }
+}
+//# sourceMappingURL=mento-fx.service.js.map

package/build/services/mento-fx.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mento-fx.service.js","sourceRoot":"","sources":["../../src/services/mento-fx.service.ts"],"names":[],"mappings":"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"}

package/build/tools/aave.tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolModule } from "./types.js";
+export declare const aaveTools: ToolModule;

package/build/tools/aave.tools.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { err, ok } from "./helpers.js";
+const encryptedPrivateKeySchema = z
+    .string()
+    .optional()
+    .describe("RSA-OAEP encrypted private key (base64). Encrypt locally with get_wallet_encryption_public_key.");
+export const aaveTools = {
+    register(server, ctx) {
+        server.registerTool("supply_aave_usdt", {
+            title: "Supply Aave USDT",
+            description: "Supply (lend) USDT to Aave V3 on Celo mainnet. Deposits USDT and receives aUSDT interest-bearing tokens. Sends ERC-20 approval first if needed. User must encrypt their private key with the server's public key (get_wallet_encryption_public_key) before calling.",
+            inputSchema: z.object({
+                amount: z.string().describe("Human-readable USDT amount, e.g. 100"),
+                encryptedPrivateKey: encryptedPrivateKeySchema,
+            }),
+            annotations: {
+                destructiveHint: true,
+                openWorldHint: true,
+            },
+        }, async ({ amount, encryptedPrivateKey }) => {
+            try {
+                return ok(await ctx.aave.supplyUsdt(amount, encryptedPrivateKey));
+            }
+            catch (error) {
+                return err(error instanceof Error ? error.message : String(error));
+            }
+        });
+        server.registerTool("withdraw_aave_usdt", {
+            title: "Withdraw Aave USDT",
+            description: "Withdraw USDT from Aave V3 on Celo mainnet by redeeming aUSDT. User must encrypt their private key with the server's public key (get_wallet_encryption_public_key) before calling.",
+            inputSchema: z.object({
+                amount: z
+                    .string()
+                    .optional()
+                    .describe("Human-readable USDT amount, e.g. 100 (omit when withdrawMax is true)"),
+                withdrawMax: z
+                    .boolean()
+                    .optional()
+                    .describe("Withdraw the full supplied USDT balance from Aave"),
+                encryptedPrivateKey: encryptedPrivateKeySchema,
+            }),
+            annotations: {
+                destructiveHint: true,
+                openWorldHint: true,
+            },
+        }, async ({ amount, withdrawMax, encryptedPrivateKey }) => {
+            try {
+                return ok(await ctx.aave.withdrawUsdt(amount, encryptedPrivateKey, withdrawMax));
+            }
+            catch (error) {
+                return err(error instanceof Error ? error.message : String(error));
+            }
+        });
+    },
+};
+//# sourceMappingURL=aave.tools.js.map

package/build/tools/aave.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave.tools.js","sourceRoot":"","sources":["../../src/tools/aave.tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,yBAAyB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,iGAAiG,CAClG,CAAC;AAEJ,MAAM,CAAC,MAAM,SAAS,GAAe;IACnC,QAAQ,CAAC,MAAiB,EAAE,GAAe;QACzC,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;YACE,KAAK,EAAE,kBAAkB;YACzB,WAAW,EACT,qQAAqQ;YACvQ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;gBACnE,mBAAmB,EAAE,yBAAyB;aAC/C,CAAC;YACF,WAAW,EAAE;gBACX,eAAe,EAAE,IAAI;gBACrB,aAAa,EAAE,IAAI;aACpB;SACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,EAAE;YACxC,IAAI,CAAC;gBACH,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;YACE,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EACT,oLAAoL;YACtL,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,MAAM,EAAE,CAAC;qBACN,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,sEAAsE,CAAC;gBACnF,WAAW,EAAE,CAAC;qBACX,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,mDAAmD,CAAC;gBAChE,mBAAmB,EAAE,yBAAyB;aAC/C,CAAC;YACF,WAAW,EAAE;gBACX,eAAe,EAAE,IAAI;gBACrB,aAAa,EAAE,IAAI;aACpB;SACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,EAAE,EAAE;YACrD,IAAI,CAAC;gBACH,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,CAAC,CACtE,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/build/tools/index.js

@@ -2,6 +2,8 @@ import { accountTools, blockchainTools } from "./blockchain.tools.js";
 import { gooddollarTools } from "./gooddollar.tools.js";
 import { tokenTools } from "./token.tools.js";
 import { transactionTools } from "./transaction.tools.js";
+import { mentoFxTools } from "./mento-fx.tools.js";
+import { aaveTools } from "./aave.tools.js";
 import { walletTools } from "./wallet.tools.js";
 export const toolModules = [
     blockchainTools,
@@ -9,6 +11,8 @@ export const toolModules = [
     tokenTools,
     walletTools,
     transactionTools,
+    mentoFxTools,
+    aaveTools,
     gooddollarTools,
 ];
 export function registerAllTools(server, ctx) {

package/build/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,eAAe;IACf,YAAY;IACZ,UAAU;IACV,WAAW;IACX,gBAAgB;IAChB,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAe;IACjE,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,eAAe;IACf,YAAY;IACZ,UAAU;IACV,WAAW;IACX,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAe;IACjE,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/build/tools/mento-fx.tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolModule } from "./types.js";
+export declare const mentoFxTools: ToolModule;

package/build/tools/mento-fx.tools.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import { addressSchema, tokenSymbolSchema } from "../schemas/common.js";
+import { err, ok } from "./helpers.js";
+const encryptedPrivateKeySchema = z
+    .string()
+    .optional()
+    .describe("RSA-OAEP encrypted private key (base64). Encrypt locally with get_wallet_encryption_public_key.");
+const mentoFxInputSchema = z.object({
+    tokenIn: tokenSymbolSchema.describe("Input token symbol or address"),
+    tokenOut: tokenSymbolSchema.describe("Output token symbol or address"),
+    amount: z.string().describe("Human-readable amount of tokenIn, e.g. 100"),
+});
+const mentoFxWalletSchema = mentoFxInputSchema.extend({
+    recipient: addressSchema
+        .optional()
+        .describe("Address that receives output tokens (defaults to signer)"),
+    slippageTolerance: z
+        .number()
+        .min(0)
+        .max(20)
+        .optional()
+        .describe("Max slippage in percent (default 0.5)"),
+    deadlineMinutes: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Transaction deadline in minutes (default 5)"),
+    encryptedPrivateKey: encryptedPrivateKeySchema,
+});
+export const mentoFxTools = {
+    register(server, ctx) {
+        server.registerTool("get_mento_fx_quote", {
+            title: "Get Mento FX Quote",
+            description: "Get an expected Mento FX conversion output for a token pair on mainnet (e.g. USDm → EURm). Oracle-priced via Mento protocol. Read-only; no wallet required.",
+            inputSchema: mentoFxInputSchema,
+            annotations: { readOnlyHint: true },
+        }, async ({ tokenIn, tokenOut, amount }) => {
+            try {
+                return ok(await ctx.mentoFx.getFxQuote(tokenIn, tokenOut, amount));
+            }
+            catch (error) {
+                return err(error instanceof Error ? error.message : String(error));
+            }
+        });
+        server.registerTool("estimate_mento_fx", {
+            title: "Estimate Mento FX",
+            description: "Estimate gas for a Mento FX conversion on mainnet, including ERC-20 approval if needed. Requires encryptedPrivateKey (hosted) or CELO_PRIVATE_KEY (local).",
+            inputSchema: mentoFxWalletSchema,
+            annotations: { readOnlyHint: true },
+        }, async ({ tokenIn, tokenOut, amount, recipient, slippageTolerance, deadlineMinutes, encryptedPrivateKey, }) => {
+            try {
+                return ok(await ctx.mentoFx.estimateFx(tokenIn, tokenOut, amount, {
+                    recipient: recipient,
+                    slippageTolerance,
+                    deadlineMinutes,
+                    encryptedPrivateKey,
+                }));
+            }
+            catch (error) {
+                return err(error instanceof Error ? error.message : String(error));
+            }
+        });
+        server.registerTool("execute_mento_fx", {
+            title: "Execute Mento FX",
+            description: "Execute a Mento FX conversion on mainnet (e.g. USDm → EURm via Mento oracle pools). Sends approval first if needed, then the FX trade. User must encrypt their private key with the server's public key (get_wallet_encryption_public_key) before calling.",
+            inputSchema: mentoFxWalletSchema,
+            annotations: {
+                destructiveHint: true,
+                openWorldHint: true,
+            },
+        }, async ({ tokenIn, tokenOut, amount, recipient, slippageTolerance, deadlineMinutes, encryptedPrivateKey, }) => {
+            try {
+                return ok(await ctx.mentoFx.executeFx(tokenIn, tokenOut, amount, {
+                    recipient: recipient,
+                    slippageTolerance,
+                    deadlineMinutes,
+                    encryptedPrivateKey,
+                }));
+            }
+            catch (error) {
+                return err(error instanceof Error ? error.message : String(error));
+            }
+        });
+    },
+};
+//# sourceMappingURL=mento-fx.tools.js.map

package/build/tools/mento-fx.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mento-fx.tools.js","sourceRoot":"","sources":["../../src/tools/mento-fx.tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,yBAAyB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,iGAAiG,CAClG,CAAC;AAEJ,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACpE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC1E,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACpD,SAAS,EAAE,aAAa;SACrB,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,mBAAmB,EAAE,yBAAyB;CAC/C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,QAAQ,CAAC,MAAiB,EAAE,GAAe;QACzC,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;YACE,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EACT,6JAA6J;YAC/J,WAAW,EAAE,kBAAkB;YAC/B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;SACpC,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;YACE,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EACT,4JAA4J;YAC9J,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;SACpC,EACD,KAAK,EAAE,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,EAAE,EAAE;YACH,IAAI,CAAC;gBACH,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;oBACtD,SAAS,EAAE,SAAsC;oBACjD,iBAAiB;oBACjB,eAAe;oBACf,mBAAmB;iBACpB,CAAC,CACH,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;YACE,KAAK,EAAE,kBAAkB;YACzB,WAAW,EACT,4PAA4P;YAC9P,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE;gBACX,eAAe,EAAE,IAAI;gBACrB,aAAa,EAAE,IAAI;aACpB;SACF,EACD,KAAK,EAAE,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,EAAE,EAAE;YACH,IAAI,CAAC;gBACH,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;oBACrD,SAAS,EAAE,SAAsC;oBACjD,iBAAiB;oBACjB,eAAe;oBACf,mBAAmB;iBACpB,CAAC,CACH,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Celina — MCP server for Celo mainnet. Balances, transfers, and chain reads for LLM agents.",
   "type": "module",
   "main": "build/index.js",
@@ -40,7 +40,10 @@
   "author": "Andrew Kim Joseph",
   "license": "MIT",
   "dependencies": {
+    "@aave/client": "^0.9.3",
+    "@mento-protocol/mento-sdk": "^3.2.8",
     "@modelcontextprotocol/sdk": "^1.22.0",
+    "dotenv": "^17.4.2",
     "express": "^5.2.1",
     "viem": "^2.39.3",
     "zod": "^3.24.3"