FreeAgent MCP Server

Instructions

Implementation Reference

• src/index.ts:198-204 (handler)

  Handler for the get_timeslip tool that extracts the ID from arguments and delegates to FreeAgentClient.getTimeslip, returning JSON response.

  case 'get_timeslip': {
    const { id } = request.params.arguments as { id: string };
    const timeslip = await this.client.getTimeslip(id);
    return {
      content: [{ type: 'text', text: JSON.stringify(timeslip, null, 2) }]
    };
  }

• src/index.ts:106-116 (registration)

  Tool registration in ListTools handler, defining name, description, and input schema requiring 'id'.

  {
    name: 'get_timeslip',
    description: 'Get a single timeslip by ID',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'Timeslip ID' }
      },
      required: ['id']
    }
  },

• src/freeagent-client.ts:73-82 (helper)

  Implementation of getTimeslip in FreeAgentClient, performs API GET request to retrieve timeslip by ID.

  async getTimeslip(id: string): Promise<Timeslip> {
      try {
          console.error('[API] Fetching timeslip:', id);
          const response = await this.axiosInstance.get<TimeslipResponse>(`/timeslips/${id}`);
          return response.data.timeslip;
      } catch (error) {
          console.error('[API] Failed to fetch timeslip:', error);
          throw error;
      }
  }

• src/types.ts:38-40 (schema)

  Type schemas for API response (TimeslipResponse) and Timeslip object used in getTimeslip.

  export interface TimeslipResponse {
      timeslip: Timeslip;
  }