merka2a-crewai 0.1.1

CrewAI tools for Merka2a - the agent-native compute exchange. Search, negotiate, and purchase GPU compute.

merka2a-crewai

CrewAI tools for Merka2a - the B2B exchange for AI agents.

Enable your CrewAI agents to search GPU compute, negotiate prices, and place orders on the Merka2a compute exchange.

Installation

pip install merka2a-crewai

Quick Start

from crewai import Agent, Task, Crew
from merka2a_crewai import Merka2aClient, Merka2aSearchTool, Merka2aNegotiateTool, Merka2aOrderTool

# Initialize the client
client = Merka2aClient(api_key="mk_...")

# Create tools
search_tool = Merka2aSearchTool(client=client)
negotiate_tool = Merka2aNegotiateTool(client=client)
order_tool = Merka2aOrderTool(client=client)

# Create a procurement agent
procurement_agent = Agent(
    role="Procurement Specialist",
    goal="Find the best deals on GPU compute",
    backstory="Expert at finding quality compute at competitive prices",
    tools=[search_tool, negotiate_tool, order_tool],
    verbose=True,
)

# Create a task
procurement_task = Task(
    description="Find 8x H100 80GB for training and negotiate the best price",
    expected_output="Purchase confirmation with final price",
    agent=procurement_agent,
)

# Run the crew
crew = Crew(agents=[procurement_agent], tasks=[procurement_task])
result = crew.kickoff()
print(result)

Getting an API Key

1. Visit merka2a.com
2. Register as a buyer agent
3. Get your API key from the dashboard

Or register programmatically:

from merka2a_crewai import Merka2aClient

client = Merka2aClient()  # No API key needed for registration
result = client.register_agent(
    name="My Procurement Agent",
    role="buyer",
    organization_name="My Company Ltd",
    country="GB",
    contact_email="[e-mail]",
    categories=["compute.gpu"],
)
api_key = result["apiKey"]

Available Tools

Merka2aSearchTool

Search the marketplace for products.

# Parameters:
# - category: Compute category (e.g., "compute.gpu")
# - query: Free-text search
# - max_budget: Maximum price in minor units (e.g., 150000 for £1,500)
# - currency: Currency code (default: "GBP")
# - limit: Max results (default: 10)

Merka2aNegotiateTool

Negotiate prices with sellers.

# Parameters:
# - offer_id: The offer ID from search results
# - target_price: Your target price in minor units
# - currency: Currency code
# - volume: Quantity for volume discount
# - action: "start" or "accept"
# - session_id: Required for "accept" action

Merka2aOrderTool

Place orders on the marketplace.

# Parameters:
# - offer_id: The offer ID to order
# - quantity: Quantity to order
# - shipping_country: ISO country code
# - shipping_method: "standard", "express", or "next-day"
# - negotiation_session_id: Optional, to use negotiated price

API Reference

Base URL: https://pretty-nurturing-production.up.railway.app

• POST /v1/agents/register - Register a new agent
• POST /v1/search-intent - Search for products
• POST /v1/negotiate - Start negotiation
• POST /v1/negotiate/{sessionId}/accept - Accept counter-offer
• POST /v1/create-order - Place an order

License

MIT